Add the initial schedule for 12.2-RELEASE.

Approved by:	re (implicit)
Sponsored by:	Rubicon Communications, LLC (netgate.com)

24 files changed, 4404 insertions, 0 deletions

diff --git a/en_US.ISO8859-1/htdocs/releases/12.2R/Makefile b/en_US.ISO8859-1/htdocs/releases/12.2R/Makefile
new file mode 100644
index 0000000000..d9bfc9f6ad
--- /dev/null
+++ b/en_US.ISO8859-1/htdocs/releases/12.2R/Makefile
@@ -0,0 +1,83 @@
+# $FreeBSD$
+
+.if exists(../Makefile.conf)
+.include "../Makefile.conf"
+.endif
+.if exists(../Makefile.inc)
+.include "../Makefile.inc"
+.endif
+.if exists(Makefile.hardware)
+.include "Makefile.hardware"
+.endif
+
+RELN_ROOT?=	${.CURDIR}
+
+DOCS=	index.xml \
+	schedule.xml
+
+DATA=	docbook.css
+
+SUBDIR= 	errata
+SUBDIR+= 	readme
+SUBDIR+= 	relnotes
+SUBDIR+= 	installation
+
+.if exists(${SVN})
+SUBDIR+=hardware
+.endif
+
+# PGP-signed checksums
+
+_BIGIRON?=	amd64 \
+		i386 \
+		powerpc \
+		powerpc-powerpc64 \
+		powerpc-powerpcspe \
+		sparc64 \
+		arm64-aarch64
+
+_VMS?=		amd64 \
+		i386 \
+		arm64-aarch64
+
+_ARM_ARMV6?=	RPI-B
+
+_ARM_ARMV7?=	BANANAPI \
+		BEAGLEBONE \
+		CUBIEBOARD \
+		CUBIEBOARD2 \
+		CUBOX-HUMMINGBOARD \
+		GENERICSD \
+		PANDABOARD \
+		RPI2 \
+		WANDBOARD
+
+_ARM64_AARCH64?=PINE64 \
+		PINE64-LTS \
+		RPI3
+
+# Do not look for checksums if BRANCH != RC* or RELEASE.
+# Special handling will be needed for cases where BRANCH
+# is RELEASE-pNN, for example, the 11.0-RELEASE really being
+# 11.0-RELEASE-p1.
+.if (${_BRANCH:MBETA*} != "" || ${_BRANCH:MRC*} != "" || ${_BRANCH:MRELEASE} != "")
+.for CHECKSUM in SHA512 SHA256
+. for _B in ${_BIGIRON}
+#DATA+=		CHECKSUM.${CHECKSUM}-${THISRELEASE}-${_B}.asc
+. endfor
+. for _V in ${_VMS}
+#DATA+=		CHECKSUM.${CHECKSUM}-${THISRELEASE}-${_V}-vm.asc
+. endfor
+. for _A in ${_ARM_ARMV6}
+#DATA+=		CHECKSUM.${CHECKSUM}-${THISRELEASE}-arm-armv6-${_A}.asc
+. endfor
+. for _A in ${_ARM_ARMV7}
+#DATA+=		CHECKSUM.${CHECKSUM}-${THISRELEASE}-arm-armv7-${_A}.asc
+. endfor
+. for _A in ${_ARM64_AARCH64}
+#DATA+=		CHECKSUM.${CHECKSUM}-${THISRELEASE}-arm64-aarch64-${_A}.asc
+. endfor
+.endfor
+.endif # _BRANCH !RC* || RELEASE*
+
+.include "${DOC_PREFIX}/share/mk/web.site.mk"
diff --git a/en_US.ISO8859-1/htdocs/releases/12.2R/Makefile.hardware b/en_US.ISO8859-1/htdocs/releases/12.2R/Makefile.hardware
new file mode 100644
index 0000000000..963fa2320f
--- /dev/null
+++ b/en_US.ISO8859-1/htdocs/releases/12.2R/Makefile.hardware
@@ -0,0 +1,19 @@
+# $FreeBSD$
+
+.include "${DOC_PREFIX}/share/mk/doc.commands.mk"
+_OS?=		FreeBSD
+_REVMAJOR?=	12
+_REVMINOR?=	1
+_REVISION?=	${_REVMAJOR}.${_REVMINOR}
+_BRANCH?=	STABLE
+THISRELEASE?=	${_OS}-${_REVISION}-${_BRANCH}
+
+HOSTNAME!=	hostname
+.if (${_BRANCH:MCURRENT*} != "" || ${_BRANCH:MALPHA*} != "")
+SRCBRANCH=	head
+.elif (${_BRANCH:MPRERELEASE} != "" || ${_BRANCH:MSTABLE*} != "")
+SRCBRANCH=	stable/${_REVMAJOR}
+.elif (${_BRANCH:MBETA*} != "" || ${_BRANCH:MRC*} != "" || \
+	${_BRANCH:MRELEASE*} != "")
+SRCBRANCH=	releng/${_REVMAJOR}.${_REVMINOR}
+.endif
diff --git a/en_US.ISO8859-1/htdocs/releases/12.2R/Makefile.inc b/en_US.ISO8859-1/htdocs/releases/12.2R/Makefile.inc
new file mode 100644
index 0000000000..7324fb3a45
--- /dev/null
+++ b/en_US.ISO8859-1/htdocs/releases/12.2R/Makefile.inc
@@ -0,0 +1,12 @@
+# $FreeBSD$
+.if !defined(_HTDOCS_RELEASES_12_1R_INC)
+_HTDOCS_RELEASES_12_1R_INC=1
+DOC_PREFIX?=	${.CURDIR}/../../../../..
+WEBDIR?=	/data/releases/12.1R
+.if defined(DESTDIR)
+DESTDIR:=	${DESTDIR}/${WEBDIR}
+.else
+DESTDIR=	${HOME}/public_html/${WEBDIR}
+.endif
+DOCBOOK_DEPS_DISABLE=	YES
+.endif
diff --git a/en_US.ISO8859-1/htdocs/releases/12.2R/docbook.css b/en_US.ISO8859-1/htdocs/releases/12.2R/docbook.css
new file mode 100644
index 0000000000..3843c6b05b
--- /dev/null
+++ b/en_US.ISO8859-1/htdocs/releases/12.2R/docbook.css
@@ -0,0 +1,403 @@
+/*
+ * Copyright (c) 2001, 2003, 2010 The FreeBSD Documentation Project
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ * 1. Redistributions of source code must retain the above copyright
+ *    notice, this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
+ * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+ * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+ * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+ * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ * SUCH DAMAGE.
+ *
+ * $FreeBSD$
+ */
+
+/*
+ * General DocBook styles from the DocBook XSL distribution
+ */
+
+.formalpara-title {
+  font-weight: bold;
+}
+
+a:link {
+	color:#0645AD;
+	text-decoration: underline;
+}
+
+a:visited, a:hover, a:active {
+	color:#663366;
+	text-decoration: underline;
+}
+
+div.blockquote-title {
+  font-weight: bold;
+  margin-top: 1em;
+  margin-bottom: 1em;
+}
+
+span.msgmain-title {
+  font-weight: bold;
+}
+
+span.msgsub-title {
+  font-weight: bold;
+}
+
+span.msgrel-title {
+  font-weight: bold;
+}
+
+div.msglevel, div.msgorig, div.msgaud {
+  margin-top: 1em;
+  margin-bottom: 1em;
+}
+
+span.msglevel-title, span.msgorig-title, span.msgaud-title {
+  font-weight: bold;
+}
+
+div.msgexplan {
+  margin-top: 1em;
+  margin-bottom: 1em;
+}
+
+span.msgexplan-title {
+  font-weight: bold;
+}
+
+div.figure-title {
+  font-weight: bold;
+}
+
+div.example-title {
+  font-weight: bold;
+}
+
+div.equation-title {
+  font-weight: bold;
+}
+
+div.table-title {
+  font-weight: bold;
+}
+
+div.sidebar-title {
+  font-weight: bold;
+}
+
+div.synopsis {
+  white-space: pre;
+  font-family: monospace;
+}
+
+/*
+ * FreeBSD-specific formatting
+ */
+
+body address {
+	line-height: 1.3;
+	margin: .6em 0;
+}
+
+html body {
+	margin: 1em 8% 1em 10%;
+	line-height: 1.2;
+}
+
+@media screen {
+	html body { font-family: sans-serif; }
+}
+
+@media print {
+	html body { font-family: serif; }
+}
+
+.legalnotice {
+	font-size: small;
+	font-variant: small-caps;
+}
+
+body div {
+	margin: 0;
+}
+
+dl {
+	margin: .4em 0 0 0;
+	line-height: 1.2;
+}
+
+dt {
+	font-weight: bold;
+	margin: 0.4em 0 0 0;
+}
+
+div.abstract div.abstract-title,
+div.toc div.toc-title,
+div.list-of-figures div.toc-title,
+div.list-of-tables div.toc-title,
+div.list-of-examples div.toc-title {
+	font-size: 115%;
+}
+
+div.calloutlist dt {
+	float: left;
+	width: 1em;}
+
+div.calloutlist dd {
+	clear: right;
+	margin-bottom: 1ex;
+}
+
+body .calloutlist td {
+	padding-right: 0.5em;
+	width: auto;
+}
+
+body .calloutlist td p {
+	line-height: 1.2;
+	margin-top: 4px;
+	margin-bottom: 4px;
+}
+
+body form {
+	margin: .6em 0;
+}
+
+div.example p b,
+.question,
+div.table p b,
+div.procedure p b {
+	color: #990000;
+}
+
+h1.title, h2.title, h3.title, h4.title, h5.title, h6.title,
+h3.author, .corpauthor,
+div.abstract div.abstract-title,
+div.toc div.toc-title,
+div.list-of-figures div.toc-title,
+div.list-of-tables div.toc-title,
+div.list-of-examples div.toc-title {
+	font-weight: bold;
+	line-height: 1.3;
+	margin-top: 1em;
+	margin-left: 0;
+	color: #990000;
+}
+
+h1.title, h2.title {
+	margin: .8em 0 0 -4%;
+}
+
+h3.title, h4.title {
+	margin: .8em 0 0 -3%;
+}
+
+h5.title {
+	margin: .8em 0 0 -2%;
+}
+
+h6.title {
+	margin: .8em 0 0 -1%;
+}
+
+body hr {
+	margin: .6em;
+	border-width: 0 0 1px 0;
+	border-style: solid;
+	border-color: #cecece;
+}
+
+body img.navheader {
+	margin: 0 0 0 -4%;
+}
+
+ol {
+	margin: 0 0 0 1em;
+	line-height: 1.2;
+}
+
+body pre {
+	margin: .75em 0;
+	font-family: monospace;
+}
+
+body td, body th {
+	line-height: 1.2;
+	padding-right: 1.5em;
+}
+
+ul, body dir, body menu {
+	margin: 0 0 0 1em;
+	line-height: 1.2;
+}
+
+html {
+	margin: 0;
+	padding: 0;
+}
+
+.filename {
+	color: #007a00;
+}
+
+.package, .port {
+  color: #007a00;
+  font-family: monospace;
+  font-style: italic;
+}
+
+.svnref {
+	color: #007a00;
+}
+
+.guimenu, .guimenuitem, .guisubmenu,
+.guilabel, .interface,
+.shortcut, .shortcut .keycap {
+	font-weight: bold;
+}
+
+.guibutton {
+	background-color: #CFCFCF;
+	padding: 2px;
+}
+
+.accel {
+	background-color: #F0F0F0;
+	text-decoration: underline;
+}
+
+pre.screen {
+	white-space: pre;
+	overflow: auto;
+	font-family: monospace;
+	padding: 1ex;
+	background-color: #edc;
+	border: 1px solid #ccc;
+	border-radius: 4px;
+}
+
+pre.programlisting {
+	white-space: pre;
+	overflow: auto;
+	font-family: monospace;
+	padding: 1ex;
+	background-color: #eee;
+	border: 1px solid #ccc;
+	border-radius: 4px;
+}
+
+@media screen {  /* hide from IE3 */
+	a[href]:hover { background: #ffa }
+}
+
+.informaltable, .table th {
+	padding-left: 0.2em;
+	text-align: left;
+}
+
+.note, .tip, .important, .warning, .caution, .example, div.procedure {
+	border-radius: 4px;
+	padding: 2ex 2ex 0 2ex;
+	margin: .75em 3em .75em 1em;
+        line-height: 1.3;
+}
+
+.note, div.procedure {
+	color: #222;
+	background: #eee;
+	border: 1px solid #ccc;
+	width: 90%;
+}
+
+.tip {
+	color: #004F00;
+	background: #d8ecd6;
+	border: 1px solid green;
+	width: 90%;
+}
+
+.important {
+	font-style:italic;
+	border: 1px solid #a00;
+	border-left: 12px solid #c00;
+	width: 90%;
+}
+
+.warning {
+	color: #9F1313;
+	background: #f8e8e8;
+	border: 1px solid #e59595;
+	width: 90%;
+}
+
+.caution {
+	color: #3E3535;
+	background: #FFC;
+	border: 1px solid #e59595;
+	width: 90%;
+}
+
+.example {
+	background: #fefde6;
+	border: 1px solid #f1bb16;
+	width: 90%;
+}
+
+.admontitle {
+	display: inline;
+	line-height: 1;
+	margin-right: 0;
+}
+
+.procedure-title {
+	font-weight: bold;
+        line-height: 1;
+        margin-right: 0;
+}
+
+.note p, .tip p, .important p, .warning p, .caution p, {
+	display: inline;
+}
+
+.informaltable table.calstable tr td {
+        padding-left: 1em;
+        padding-right: 1em;
+}
+
+.authorgroup {
+	font-style: italic;
+}
+
+.userinput,
+.userinput code {
+	font-weight: bold;
+}
+
+pre.screen strong {
+	font-weight: normal;
+}
+
+.procedure ol {
+	line-height: 1.2;
+	margin: 0 0 0 -1em;
+}
+
+span.contrib {
+	font-size: small;
+	font-style: italic;
+}
diff --git a/en_US.ISO8859-1/htdocs/releases/12.2R/errata/Makefile b/en_US.ISO8859-1/htdocs/releases/12.2R/errata/Makefile
new file mode 100644
index 0000000000..476c4e0cc6
--- /dev/null
+++ b/en_US.ISO8859-1/htdocs/releases/12.2R/errata/Makefile
@@ -0,0 +1,15 @@
+# $FreeBSD$
+
+.if exists(../Makefile.inc)
+.include "../Makefile.inc"
+.endif
+
+DOC?=			errata
+FORMATS?=		html txt
+INSTALL_COMPRESSED?=	gz
+INSTALL_ONLY_COMPRESSED=
+
+.PHONY:			${DOC}.parsed.xml
+.PHONY:			${DOC}.html
+
+.include "${DOC_PREFIX}/share/mk/doc.project.mk"
diff --git a/en_US.ISO8859-1/htdocs/releases/12.2R/errata/errata.xml b/en_US.ISO8859-1/htdocs/releases/12.2R/errata/errata.xml
new file mode 100644
index 0000000000..f6f024c012
--- /dev/null
+++ b/en_US.ISO8859-1/htdocs/releases/12.2R/errata/errata.xml
@@ -0,0 +1,127 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V5.0-Based Extension//EN"
+"../../../../../share/xml/freebsd50.dtd" [
+<!ENTITY % release PUBLIC "-//FreeBSD//ENTITIES Release Specification//EN" "../share/xml/release.ent">
+ %release;
+<!ENTITY % sponsor PUBLIC "-//FreeBSD//ENTITIES Sponsor Specification//EN" "../share/xml/sponsor.ent">
+ %sponsor;
+<!ENTITY % vendor PUBLIC "-//FreeBSD//ENTITIES Vendor Specification//EN" "../share/xml/vendor.ent">
+ %vendor;
+<!ENTITY security SYSTEM "../share/xml/security.xml">
+<!ENTITY errata SYSTEM "../share/xml/errata.xml">
+]>
+
+<article xmlns="http://docbook.org/ns/docbook"
+	xmlns:xlink="http://www.w3.org/1999/xlink"
+	version="5.0">
+  <info>
+    <title>&os; &release; Errata</title>
+
+    <author>
+      <orgname>The &os; Project</orgname>
+    </author>
+
+    <pubdate>$FreeBSD$</pubdate>
+
+    <copyright>
+      <year>2020</year>
+      <holder role="mailto:doc@FreeBSD.org">The &os; Documentation
+	Project</holder>
+    </copyright>
+
+    <legalnotice xml:id="trademarks" role="trademarks">
+      &tm-attrib.freebsd;
+      &tm-attrib.intel;
+      &tm-attrib.sparc;
+      &tm-attrib.general;
+    </legalnotice>
+
+    <abstract>
+      <para>This document lists errata items for &os; &release;,
+	containing significant information discovered after the
+	release or too late in the release cycle to be otherwise
+	included in the release documentation.  This information
+	includes security advisories, as well as news relating to the
+	software or documentation that could affect its operation or
+	usability.  An up-to-date version of this document should
+	always be consulted before installing this version of
+	&os;.</para>
+
+      <para>This errata document for &os; &release; will be maintained
+	until the release of &os; &release.next;.</para>
+    </abstract>
+  </info>
+
+  <sect1 xml:id="intro">
+    <title>Introduction</title>
+
+    <para>This errata document contains <quote>late-breaking
+	news</quote> about &os; &release; Before installing this
+      version, it is important to consult this document to learn about
+      any post-release discoveries or problems that may already have
+      been found and fixed.</para>
+
+    <para>Any version of this errata document actually distributed
+      with the release (for example, on a CDROM distribution) will be
+      out of date by definition, but other copies are kept updated on
+      the Internet and should be consulted as the <quote>current
+	errata</quote> for this release.  These other copies of the
+      errata are located at <link
+	xlink:href="https://www.FreeBSD.org/releases/" />, plus any
+      sites which keep up-to-date mirrors of this location.</para>
+
+    <para>Source and binary snapshots of &os; &release.branch; also
+      contain up-to-date copies of this document (as of the time of
+      the snapshot).</para>
+
+    <para>For a list of all &os; CERT security advisories, see
+      <link xlink:href="https://www.FreeBSD.org/security/"/>.</para>
+  </sect1>
+
+  <sect1 xml:id="security">
+    <title>Security Advisories</title>
+
+    &security;
+  </sect1>
+
+  <sect1 xml:id="errata">
+    <title>Errata Notices</title>
+
+    &errata;
+  </sect1>
+
+  <sect1 xml:id="open-issues">
+    <title>Open Issues</title>
+
+    <itemizedlist>
+      <listitem>
+	<para>[2019-11-04] A late issue was discovered where systems
+	  using the <filename
+	    role="package">graphics/drm-kmod</filename> port built on
+	  &os;&nbsp;12.0-RELEASE will crash during boot.  It is
+	  advised to remove the port prior to upgrading, and build the
+	  port instead of using the upstream binary package.</para>
+      </listitem>
+    </itemizedlist>
+  </sect1>
+
+  <sect1 xml:id="late-news">
+    <title>Late-Breaking News</title>
+
+    <itemizedlist>
+      <listitem>
+	<para>[2019-11-22] The &os;&nbsp;12.1-RELEASE announcement
+	  includes mention of &os;/&arch.amd64; Amazon&reg; EC2&trade;
+	  <acronym>AMI</acronym>s (Amazon Machine Images).  Though it
+	  also included mention of &os;/&arch.arm64; being available
+	  in various regions, it had not passed third-party validation
+	  for inclusion in the Amazon&reg; Marketplace.</para>
+
+	<para>&os;&nbsp;12.1-RELEASE &arch.arm64; Amazon&reg;
+	  EC2&trade; <acronym>AMI</acronym>s are now available in the
+	  Marketplace <link
+	    xlink:href="https://aws.amazon.com/marketplace/pp/B081NF7BY7">here</link>.</para>
+      </listitem>
+    </itemizedlist>
+  </sect1>
+</article>
diff --git a/en_US.ISO8859-1/htdocs/releases/12.2R/hardware/Makefile b/en_US.ISO8859-1/htdocs/releases/12.2R/hardware/Makefile
new file mode 100644
index 0000000000..5c5e8fdbbd
--- /dev/null
+++ b/en_US.ISO8859-1/htdocs/releases/12.2R/hardware/Makefile
@@ -0,0 +1,49 @@
+# $FreeBSD$
+
+.if exists(../Makefile.inc)
+.include "../Makefile.inc"
+.endif
+.if exists(../Makefile.hardware)
+.include "../Makefile.hardware"
+.endif
+
+ARCHLIST?=	${DOC_PREFIX}/share/misc/dev.archlist.txt
+
+MAN2HWNOTES_CMD=${DOC_PREFIX}/share/misc/man2hwnotes.pl
+.if defined(HWNOTES_MI)
+MAN2HWNOTES_FLAGS=
+.else
+MAN2HWNOTES_FLAGS=	-c
+.endif
+
+DOC?=			hardware
+FORMATS?=		html txt
+INSTALL_COMPRESSED?=	gz
+INSTALL_ONLY_COMPRESSED=
+
+.if ${.TARGET:M${DOC}.html}
+MAN4TMP!=	${MKTEMP} -d ${.CURDIR}/svn.XXXXXXXX
+MAN4DIR=	${MAN4TMP}
+.if exists(${MAN4DIR})
+	rm -rf ${MAN4DIR}
+.endif
+
+MAN4PAGES?=	${MAN4DIR}/*.4 ${MAN4DIR}/man4.*/*.4
+hardware.parsed.xml:	dev-auto.ent man4-rmsrc
+dev-auto.ent:	man4-src-checkout
+	${PERL} ${MAN2HWNOTES_CMD} ${MAN2HWNOTES_FLAGS} -a ${ARCHLIST} -o ${.TARGET} ${MAN4PAGES} || (rm -f ${.TARGET})
+CLEANFILES+=	dev-auto.ent
+CLEANDIRS+=	${.CURDIR}/svn.*
+
+.ORDER:			man4-rmsrc man4-src-checkout
+man4-src-checkout:
+	mkdir -p ${MAN4TMP}
+	${SVN} co svn://svn.freebsd.org/base/${SRCBRANCH}/share/man/man4 \
+		${MAN4TMP}
+
+man4-rmsrc:
+	@# Just in case.
+	rm -rf ${MAN4DIR} || true
+.endif
+
+.include "${DOC_PREFIX}/share/mk/doc.project.mk"
diff --git a/en_US.ISO8859-1/htdocs/releases/12.2R/hardware/hardware.xml b/en_US.ISO8859-1/htdocs/releases/12.2R/hardware/hardware.xml
new file mode 100644
index 0000000000..2df82630f3
--- /dev/null
+++ b/en_US.ISO8859-1/htdocs/releases/12.2R/hardware/hardware.xml
@@ -0,0 +1,1477 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V5.0-Based Extension//EN"
+    "http://www.FreeBSD.org/XML/share/xml/freebsd50.dtd" [
+<!ENTITY % release PUBLIC "-//FreeBSD//ENTITIES Release Specification//EN"
+    "../share/xml/release.ent">
+ %release;
+<!ENTITY % sponsor PUBLIC "-//FreeBSD//ENTITIES Sponsor Specification//EN"
+    "../share/xml/sponsor.ent">
+ %sponsor;
+<!ENTITY % vendor PUBLIC "-//FreeBSD//ENTITIES Vendor Specification//EN"
+    "../share/xml/vendor.ent">
+ %vendor;
+<!ENTITY security SYSTEM "../share/xml/security.xml">
+<!ENTITY errata SYSTEM "../share/xml/errata.xml">
+<!ENTITY % devauto PUBLIC "-//FreeBSD//ENTITIES Auto Generated Device Lists//EN"
+    "http://www.FreeBSD.org/XML/cwd/dev-auto.ent">
+%devauto;
+]>
+<article xmlns="http://docbook.org/ns/docbook"
+  xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
+
+  <info>
+    <title>&os; &release.current; Hardware Notes</title>
+
+    <author>
+      <orgname>The &os; Documentation Project</orgname>
+    </author>
+
+    <pubdate>$FreeBSD$</pubdate>
+    <copyright>
+      <year>2000</year>
+      <year>2001</year>
+      <year>2002</year>
+      <year>2003</year>
+      <year>2004</year>
+      <year>2005</year>
+      <year>2006</year>
+      <year>2007</year>
+      <year>2008</year>
+      <year>2009</year>
+      <year>2010</year>
+      <year>2011</year>
+      <year>2012</year>
+      <year>2013</year>
+      <year>2014</year>
+      <year>2015</year>
+      <year>2016</year>
+      <year>2017</year>
+      <year>2018</year>
+      <year>2019</year>
+      <year>2020</year>
+      <holder role="mailto:doc@FreeBSD.org">The &os; Documentation
+	Project</holder>
+    </copyright>
+
+    <legalnotice xml:id="trademarks" role="trademarks">
+      &tm-attrib.freebsd;
+      &tm-attrib.amd;
+      &tm-attrib.fujitsu;
+      &tm-attrib.ibm;
+      &tm-attrib.intel;
+      &tm-attrib.sparc;
+      &tm-attrib.sun;
+      &tm-attrib.general;
+    </legalnotice>
+
+  </info>
+
+  <sect1 xml:id="intro">
+    <title>Introduction</title>
+
+    <para>This document contains the hardware compatibility notes for
+      &os; &release.current;.  It lists the hardware platforms
+      supported by &os;, as well as the various types of hardware
+      devices (storage controllers, network interfaces, and so on),
+      along with known working instances of these devices.</para>
+  </sect1>
+
+  <sect1 xml:id="proc">
+    <title>Supported Processors and System Boards</title>
+
+    <para>This section provides some architecture-specific information
+      about the specific processors and systems that are supported by
+      each architecture.</para>
+
+    <sect2 xml:id="proc-amd64">
+      <title>amd64</title>
+
+      <para>Since mid-2003 &os;/&arch.amd64; has supported the AMD64
+	(<quote>Hammer</quote>) and &intel; EM64T architecture, and is
+	now one of the Tier-1 platforms (fully supported
+	architecture), which are expected to be Production Quality
+	with respects to all aspects of the &os; operating system,
+	including installation and development environments.</para>
+
+      <para>Note that there are two names for this architecture, AMD64
+	(AMD) and Intel EM64T (Extended Memory 64-bit Technology).
+	64-bit mode of the two architectures are almost compatible
+	with each other, and &os;/&arch.amd64; supports them
+	both.</para>
+
+      <para>As of this writing, the following processors are
+	supported:</para>
+
+      <itemizedlist>
+	<listitem>
+	  <para>&amd.athlon;64 (<quote>Clawhammer</quote>).</para>
+	</listitem>
+
+	<listitem>
+	  <para>&amd.opteron; (<quote>Sledgehammer</quote>).</para>
+	</listitem>
+
+	<listitem>
+	  <para>&amd.sempron;.</para>
+	</listitem>
+
+	<listitem>
+	  <para>&amd.turion;.</para>
+	</listitem>
+
+	<listitem>
+	  <para>&amd.phenom;.</para>
+	</listitem>
+
+	<listitem>
+	  <para>All multi-core &intel; &xeon; processors except
+	    Sossaman have EM64T support.</para>
+	</listitem>
+
+	<listitem>
+	  <para>The single-core &intel; &xeon; processors
+	    <quote>Nocona</quote>, <quote>Irwindale</quote>,
+	    <quote>Potomac</quote>, and <quote>Cranford</quote> have
+	    EM64T support.</para>
+	</listitem>
+
+	<listitem>
+	  <para>All &intel; &core; 2 (not &core; Duo) and later
+	    processors</para>
+	</listitem>
+
+	<listitem>
+	  <para>All &intel; &core; i range of processors</para>
+	</listitem>
+
+	<listitem>
+	  <para>All &intel; &pentium; D processors</para>
+	</listitem>
+
+	<listitem>
+	  <para>All &intel; &centrino; Duo and &centrino; Pro
+	    platforms</para>
+	</listitem>
+
+	<listitem>
+	  <para>&intel; &pentium; 4s and &celeron; Ds using
+	    the <quote>Cedar Mill</quote> core have EM64T
+	    support.</para>
+	</listitem>
+
+	<listitem>
+	  <para>Some &intel; &pentium; 4s and &celeron; Ds using the
+	    <quote>Prescott</quote> core have EM64T support.  See the
+	    <link xlink:href="http://processorfinder.intel.com">Intel
+	      Processor Spec Finder</link> for the definitive answer
+	    about EM64T support in Intel processors.</para>
+	</listitem>
+
+      </itemizedlist>
+
+      <para>&intel; EM64T is an extended version of IA-32 (x86) and
+	different from &intel; IA-64 (Itanium) architecture.  Some of
+	&intel;'s old documentation refers to &intel; EM64T as
+	<quote>64-bit extension technology</quote> or
+	<quote>IA-32e</quote>.</para>
+
+      <para>Both Uniprocessor (UP) and Symmetric Multi-processor (SMP)
+	configurations are supported.</para>
+
+      <para>In many respects, &os;/&arch.amd64; is similar to
+	&os;/&arch.i386;, in terms of drivers supported.  Generally,
+	drivers that already function correctly on other 64-bit
+	platforms should work.</para>
+    </sect2>
+
+    <sect2 xml:id="proc-i386">
+      <title>i386</title>
+
+      <para>&os;/&arch.i386; runs on a wide variety of <quote>IBM PC
+	  compatible</quote> machines.  Due to the wide range of
+	hardware available for this architecture, it is impossible
+	to exhaustively list all combinations of equipment supported
+	by &os;.  Nevertheless, some general guidelines are
+	presented here.</para>
+
+      <para>Almost all &i386;-compatible processors with a floating
+	point unit are supported.  All &intel; processors beginning
+	with the 80486 are supported, including the 80486, &pentium;,
+	&pentium; Pro, &pentium; II, &pentium; III, &pentium; 4, and
+	variants thereof, such as the &xeon; and &celeron; processors.
+	All &i386;-compatible AMD processors are also supported,
+	including the &am486;, &am5x86;, K5, &amd.k6; (and variants),
+	&amd.athlon; (including Athlon-MP, Athlon-XP, Athlon-4, and
+	Athlon Thunderbird), and &amd.duron; processors.  The AMD
+	&Eacute;lan SC520 embedded processor is supported.  The
+	Transmeta Crusoe is recognized and supported, as are
+	&i386;-compatible processors from Cyrix and NexGen.</para>
+
+      <para>There is a wide variety of motherboards available for this
+	architecture.  Motherboards using the ISA, VLB, EISA, AGP, and
+	PCI expansion buses are well-supported.  There is some
+	limited support for the MCA (<quote>MicroChannel</quote>)
+	expansion bus used in the IBM PS/2 line of PCs.</para>
+
+      <para>Symmetric multi-processor (SMP) systems are generally
+	supported by &os;, although in some cases, BIOS or motherboard
+	bugs may generate some problems.  Perusal of the archives of
+	the &a.smp; may yield some clues.</para>
+
+      <para>&os; will take advantage of SMT (Symmetric MultiThreading,
+	also known as HyperThreading on &intel; CPUs) on the supported
+	CPUs.  The <filename>GENERIC</filename> kernel which is
+	installed by default will automatically detect the additional
+	logical processors.  The default &os; scheduler recognizes
+	processor topology on the system and selects logical and
+	physical processors to obtain optimal performance.
+	The &man.smp.4; manual page has more details.</para>
+
+      <para>&os; will take advantage of Physical Address Extensions
+	(PAE) support on CPUs that support this feature.  A kernel
+	with the <literal>PAE</literal> feature enabled will detect
+	memory above 4 gigabytes and allow it to be used by the
+	system.  This feature places constraints on the device drivers
+	and other features of &os; which may be used; consult the
+	&man.pae.4; manual page for more details.</para>
+
+      <para>&os; will generally run on i386-based laptops, albeit with
+	varying levels of support for certain hardware features such
+	as sound, graphics, power management, and PCCARD expansion
+	slots.  These features tend to vary in idiosyncratic ways
+	between machines, and frequently require special-case support
+	in &os; to work around hardware bugs or other oddities.  When
+	in doubt, a search of the archives of the &a.mobile; may be
+	useful.</para>
+
+      <para>Most modern laptops (as well as many desktops) use the
+	Advanced Configuration and Power Management (ACPI) standard.
+	&os; supports ACPI via the ACPI Component Architecture
+	reference implementation from &intel;, as described in the
+	&man.acpi.4; manual page.  The use of ACPI causes
+	instabilities on some machines and it may be necessary to
+	disable the ACPI driver, which is normally loaded via a kernel
+	module.  This may be accomplished by adding the following line
+	to <filename>/boot/device.hints</filename>:</para>
+
+      <programlisting>hint.acpi.0.disabled="1"</programlisting>
+
+      <para>Users debugging ACPI-related problems may find it useful
+	to disable portions of the ACPI functionality.  The
+	&man.acpi.4; manual page has more information on how to do
+	this via loader tunables.</para>
+
+      <para>ACPI depends on a Differentiated System Descriptor Table
+	(DSDT) provided by each machine's BIOS.  Some machines have
+	bad or incomplete DSDTs, which prevents ACPI from functioning
+	correctly.  Replacement DSDTs for some machines can be found
+	at the <link
+	  xlink:href="http://acpi.sourceforge.net/dsdt/index.php">DSDT</link>
+	section of the <link
+	  xlink:href="http://acpi.sourceforge.net/">ACPI4Linux</link>
+	project Web site.  &os; can use these DSDTs to override the
+	DSDT provided by the BIOS; see the &man.acpi.4; manual page
+	for more information.</para>
+    </sect2>
+
+    <sect2 xml:id="proc-powerpc">
+      <title>powerpc</title>
+
+      <para>All Apple PowerPC machines with built-in USB are
+	supported, as well a limited selection of non-Apple machines,
+	including KVM on POWER7</para>
+
+      <para>SMP is supported on all systems with more than
+	1 processor.</para>
+    </sect2>
+
+    <sect2 xml:id="proc-sparc64">
+      <title>sparc64</title>
+
+      <para>This section describes the systems currently known to be
+	supported by &os; on the Fujitsu &sparc64; and Sun
+	&ultrasparc; platforms.</para>
+
+      <para>SMP is supported on all systems with more than 1
+	processor.</para>
+
+      <para>When using the <filename>GENERIC</filename> kernel,
+	&os;/&arch.sparc64; systems not equipped with a framebuffer
+	supported by the &man.creator.4; (Sun Creator, Sun Creator3D
+	and Sun Elite3D) or &man.machfb.4; (Sun PGX and Sun PGX64 as
+	well as the ATI Mach64 chips found onboard in for example
+	&sun.blade; 100, &sun.blade; 150, &sun.ultra; 5 and
+	&sun.ultra; 10) driver must use the serial console.</para>
+
+      <para>If you have a system that is not listed here, it may not
+	have been tested with &os; &release.current;.  We encourage
+	you to try it and send a note to the &a.sparc; with your
+	results, including which devices work and which do not.</para>
+
+      <para>The following systems are fully supported by &os;:</para>
+
+      <itemizedlist>
+	<listitem>
+	  <para>Naturetech GENIALstation 777S</para>
+	</listitem>
+
+	<listitem>
+	  <para>&sun.blade; 100</para>
+	</listitem>
+
+	<listitem>
+	  <para>&sun.blade; 150</para>
+	</listitem>
+
+	<listitem>
+	  <para>&sun.enterprise; 150</para>
+	</listitem>
+
+	<listitem>
+	  <para>&sun.enterprise; 220R</para>
+	</listitem>
+
+	<listitem>
+	  <para>&sun.enterprise; 250</para>
+	</listitem>
+
+	<listitem>
+	  <para>&sun.enterprise; 420R</para>
+	</listitem>
+
+	<listitem>
+	  <para>&sun.enterprise; 450</para>
+	</listitem>
+
+	<listitem>
+	  <para>&sun.fire; B100s (support for the on-board NICs first
+	    appeared in 8.1-RELEASE)</para>
+	</listitem>
+
+	<listitem>
+	  <para>&sun.fire; V100</para>
+	</listitem>
+
+	<listitem>
+	  <para>&sun.fire; V120</para>
+	</listitem>
+
+	<listitem>
+	  <para>Sun &netra; t1 100/105</para>
+	</listitem>
+
+	<listitem>
+	  <para>Sun &netra; T1 AC200/DC200</para>
+	</listitem>
+
+	<listitem>
+	  <para>Sun &netra; t 1100</para>
+	</listitem>
+
+	<listitem>
+	  <para>Sun &netra; t 1120</para>
+	</listitem>
+
+	<listitem>
+	  <para>Sun &netra; t 1125</para>
+	</listitem>
+
+	<listitem>
+	  <para>Sun &netra; t 1400/1405</para>
+	</listitem>
+
+	<listitem>
+	  <para>Sun &netra; 120</para>
+	</listitem>
+
+	<listitem>
+	  <para>Sun &netra; X1</para>
+	</listitem>
+
+	<listitem>
+	  <para>Sun &sparcengine; Ultra AX1105</para>
+	</listitem>
+
+	<listitem>
+	  <para>Sun &sparcengine; Ultra AXe</para>
+	</listitem>
+
+	<listitem>
+	  <para>Sun &sparcengine; Ultra AXi</para>
+	</listitem>
+
+	<listitem>
+	  <para>Sun &sparcengine; Ultra AXmp</para>
+	</listitem>
+
+	<listitem>
+	  <para>Sun &sparcengine; CP1500</para>
+	</listitem>
+
+	<listitem>
+	  <para>&sun.ultra; 1</para>
+	</listitem>
+
+	<listitem>
+	  <para>&sun.ultra; 1E</para>
+	</listitem>
+
+	<listitem>
+	  <para>&sun.ultra; 2</para>
+	</listitem>
+
+	<listitem>
+	  <para>&sun.ultra; 5</para>
+	</listitem>
+
+	<listitem>
+	  <para>&sun.ultra; 10</para>
+	</listitem>
+
+	<listitem>
+	  <para>&sun.ultra; 30</para>
+	</listitem>
+
+	<listitem>
+	  <para>&sun.ultra; 60</para>
+	</listitem>
+
+	<listitem>
+	  <para>&sun.ultra; 80</para>
+	</listitem>
+
+	<listitem>
+	  <para>&sun.ultra; 450</para>
+	</listitem>
+      </itemizedlist>
+
+      <para>The following systems are partially supported by &os;.  In
+	particular the fiber channel controllers in SBus-based systems
+	are not supported.  However, it is possible to use these with
+	a SCSI controller supported by the &man.esp.4; driver (Sun ESP
+	SCSI, Sun FAS Fast-SCSI and Sun FAS366 Fast-Wide SCSI
+	controllers).</para>
+
+      <itemizedlist>
+	<listitem>
+	  <para>&sun.enterprise; 3500</para>
+	</listitem>
+
+	<listitem>
+	  <para>&sun.enterprise; 4500</para>
+	</listitem>
+      </itemizedlist>
+
+      <para>Starting with 7.2-RELEASE, &arch.sparc64; systems based on
+	Sun &ultrasparc; III and beyond are also supported by &os;,
+	which includes the following known working systems:</para>
+
+      <itemizedlist>
+	<listitem>
+	  <para>&sun.blade; 1000</para>
+	</listitem>
+
+	<listitem>
+	  <para>&sun.blade; 1500</para>
+	</listitem>
+
+	<listitem>
+	  <para>&sun.blade; 2000</para>
+	</listitem>
+
+	<listitem>
+	  <para>&sun.blade; 2500</para>
+	</listitem>
+
+	<listitem>
+	  <para>&sun.fire; 280R</para>
+	</listitem>
+
+	<listitem>
+	  <para>&sun.fire; V210</para>
+	</listitem>
+
+	<listitem>
+	  <para>&sun.fire; V215 (support first appeared in 7.3-RELEASE
+	    and 8.1-RELEASE)</para>
+	</listitem>
+
+	<listitem>
+	  <para>&sun.fire; V240</para>
+	</listitem>
+
+	<listitem>
+	  <para>&sun.fire; V245 (support first appeared in 7.3-RELEASE
+	    and 8.1-RELEASE)</para>
+	</listitem>
+
+	<listitem>
+	  <para>&sun.fire; V250</para>
+	</listitem>
+
+	<listitem>
+	  <para>&sun.fire; V440 (support for the on-board NICs first
+	    appeared in 7.3-RELEASE and 8.0-RELEASE)</para>
+	</listitem>
+
+	<listitem>
+	  <para>&sun.fire; V480 (501-6780 and 501-6790 centerplanes
+	    only, for which support first appeared in 7.3-RELEASE and
+	    8.1-RELEASE, other centerplanes might work beginning with
+	    8.3-RELEASE and 9.0-RELEASE)</para>
+	</listitem>
+
+	<listitem>
+	  <para>&sun.fire; V880</para>
+	</listitem>
+
+	<listitem>
+	  <para>&sun.fire; V890 (support first appeared in 7.4-RELEASE
+	    and 8.1-RELEASE, non-mixed &ultrasparc; IV/IV+
+	    CPU-configurations only)</para>
+	</listitem>
+
+	<listitem>
+	  <para>&netra; 20/&netra; T4</para>
+	</listitem>
+      </itemizedlist>
+
+      <para>The following Sun &ultrasparc; systems are not tested but
+	believed to be also supported by &os;:</para>
+
+      <itemizedlist>
+	<listitem>
+	  <para>&sun.fire; V125</para>
+	</listitem>
+
+	<listitem>
+	  <para>&sun.fire; V490 (support first appeared in 7.4-RELEASE
+	    and 8.1-RELEASE, non-mixed &ultrasparc; IV/IV+
+	    CPU-configurations only)</para>
+	</listitem>
+      </itemizedlist>
+
+      <para>Starting with 7.4-RELEASE and 8.1-RELEASE, &arch.sparc64;
+	systems based on Fujitsu &sparc64; V are also supported by
+	&os;, which includes the following known working
+	systems:</para>
+
+      <itemizedlist>
+	<listitem>
+	  <para>Fujitsu &primepower; 250</para>
+	</listitem>
+      </itemizedlist>
+
+      <para>The following Fujitsu &primepower; systems are not tested
+	but believed to be also supported by &os;:</para>
+
+      <itemizedlist>
+	<listitem>
+	  <para>Fujitsu &primepower; 450</para>
+	</listitem>
+
+	<listitem>
+	  <para>Fujitsu &primepower; 650</para>
+	</listitem>
+
+	<listitem>
+	  <para>Fujitsu &primepower; 850</para>
+	</listitem>
+      </itemizedlist>
+
+    </sect2>
+  </sect1>
+
+  <!--
+
+  The "Supported Devices" section of the release notes.
+  Generally processor-independent, with conditional text
+  inclusion handling any architecture-dependent text.
+
+  Within each subsection describing a class of hardware
+  (i.e. Ethernet interfaces), list broad groups of devices
+  alphabetically as paragraphs sorted alphabetically (frequently
+  these groups will be arranged by manufacturer, i.e. 3Com
+  Ethernet interfaces).
+
+  Where applicable, a "Miscellaneous" section may follow all
+  other named sections.
+
+  These guidelines are not hard-and-fast rules, and exceptions
+  will occur.  Following these guidelines (vague as they may be)
+  is highly recommended to try to keep the formatting of
+  this section consistent.
+
+  We give manpage references using the &man entities where
+  possible.  If a driver has no manpage (and consequently no
+  &man entity, we simply give the name of the driver).
+  Please avoid doing &man entity conversions unless you
+  know for sure that an entity and manpage exist; sweeps through
+  this file to fix "missed" conversions are likely to break the
+  build.
+  -->
+
+  <sect1 xml:id="support">
+    <title>Supported Devices</title>
+
+    <para>This section describes the devices currently known to be
+      supported by &os;.  Other configurations may also work, but
+      simply have not been tested yet.  Feedback, updates, and
+      corrections to this list are encouraged.</para>
+
+    <para>Where possible, the drivers applicable to each device or
+      class of devices is listed.  If the driver in question has a
+      manual page in the &os; base distribution (most should), it is
+      referenced here.  Information on specific models of supported
+      devices, controllers, etc. can be found in the manual
+      pages.</para>
+
+    <note>
+      <para>The device lists in this document are being generated
+	automatically from &os; manual pages.  This means that some
+	devices, which are supported by multiple drivers, may appear
+	multiple times.</para>
+    </note>
+
+    <sect2 xml:id="disk">
+      <title>Disk Controllers</title>
+
+      <para>[&arch.amd64;, &arch.i386;, &arch.sparc64;]
+	IDE/ATA controllers (&man.ata.4; driver)</para>
+
+      &hwlist.aac;
+
+      &hwlist.adv;
+
+      &hwlist.adw;
+
+      &hwlist.aha;
+
+      &hwlist.ahc;
+
+      &hwlist.ahci;
+
+      &hwlist.ahd;
+
+      &hwlist.aic;
+
+      &hwlist.amr;
+
+      &hwlist.arcmsr;
+
+      &hwlist.bt;
+
+      &hwlist.ciss;
+
+      &hwlist.dpt;
+
+      <note>
+	<para>[&arch.amd64;, &arch.i386;] Booting from these
+	  controllers is supported.  EISA adapters are not
+	  supported.</para>
+      </note>
+
+      &hwlist.esp;
+
+      &hwlist.hpt27xx;
+
+      &hwlist.hptiop;
+
+      &hwlist.hptmv;
+
+      &hwlist.hptrr;
+
+      &hwlist.ida;
+
+      &hwlist.iir;
+
+      &hwlist.ips;
+
+      &hwlist.isci;
+
+      &hwlist.isp;
+
+      &hwlist.mfi;
+
+      &hwlist.mlx;
+
+      <note>
+	<para>[&arch.amd64;, &arch.i386;] Booting from these
+	  controllers is supported.  EISA adapters are not
+	  supported.</para>
+      </note>
+
+      &hwlist.mly;
+
+      &hwlist.mpr;
+
+      &hwlist.mps;
+
+      &hwlist.mpt;
+
+      &hwlist.mrsas;
+
+      &hwlist.mvs;
+
+      &hwlist.ncr;
+
+      &hwlist.ncv;
+
+      &hwlist.nsp;
+
+      &hwlist.pms;
+
+      &hwlist.pst;
+
+      &hwlist.siis;
+
+      &hwlist.stg;
+
+      &hwlist.sym;
+
+      &hwlist.trm;
+
+      &hwlist.twa;
+
+      &hwlist.twe;
+
+      &hwlist.tws;
+
+      &hwlist.vpo;
+
+      <para>With all supported SCSI controllers, full support is
+	provided for SCSI-I, SCSI-II, and SCSI-III peripherals,
+	including hard disks, optical disks, tape drives (including
+	DAT, 8mm Exabyte, Mammoth, and DLT), medium changers,
+	processor target devices and CD-ROM drives.  WORM devices that
+	support CD-ROM commands are supported for read-only access by
+	the CD-ROM drivers (such as &man.cd.4;).  WORM/CD-R/CD-RW
+	writing support is provided by &man.cdrecord.1;, which is
+	a part of the <package>sysutils/cdrtools</package> port in the
+	Ports Collection.</para>
+
+      <para>The following CD-ROM type systems are supported at this
+	time:</para>
+
+      <itemizedlist>
+	<listitem>
+	  <para>SCSI interface (also includes ProAudio Spectrum and
+	    SoundBlaster SCSI) (&man.cd.4;)</para>
+	</listitem>
+
+	<listitem>
+	  <para>ATAPI IDE interface (&man.acd.4;)</para>
+	</listitem>
+      </itemizedlist>
+    </sect2>
+
+    <sect2 xml:id="ethernet">
+      <title>Ethernet Interfaces</title>
+
+      &hwlist.ae;
+
+      &hwlist.age;
+
+      &hwlist.ale;
+
+      &hwlist.aue;
+
+      &hwlist.axe;
+
+      <para>ASIX Electronics AX88178A/AX88179 USB Gigabit Ethernet
+	adapters (&man.axge.4; driver)</para>
+
+      &hwlist.bce;
+
+      <para>[&arch.amd64;, &arch.i386;] Broadcom BCM4401 based Fast
+	Ethernet adapters (&man.bfe.4; driver)</para>
+
+      &hwlist.bge;
+
+      &hwlist.bnxt;
+
+      &hwlist.bxe;
+
+      &hwlist.cas;
+
+      &hwlist.cdce;
+
+      <para>[&arch.amd64;, &arch.i386;] Crystal Semiconductor
+	CS89x0-based NICs (&man.cs.4; driver)</para>
+
+      &hwlist.cue;
+
+      &hwlist.cxgb;
+
+      &hwlist.cxgbe;
+
+      &hwlist.dc;
+
+      &hwlist.de;
+
+      &hwlist.ed;
+
+      &hwlist.em;
+
+      &hwlist.ep;
+
+      <para>Agere ET1310 Gigabit Ethernet adapters
+	(&man.et.4; driver)</para>
+
+      &hwlist.ex;
+
+      &hwlist.fe;
+
+      &hwlist.fxp;
+
+      &hwlist.gem;
+
+      &hwlist.hme;
+
+      &hwlist.ipheth;
+
+      &hwlist.ixgbe;
+
+      &hwlist.ixl;
+
+      &hwlist.jme;
+
+      &hwlist.kue;
+
+      &hwlist.lge;
+
+      &hwlist.mlx4en;
+
+      &hwlist.mlx5en;
+
+      &hwlist.msk;
+
+      &hwlist.mxge;
+
+      &hwlist.my;
+
+      &hwlist.nfe;
+
+      &hwlist.nge;
+
+      &hwlist.oce;
+
+      &hwlist.pcn;
+
+      &hwlist.qlxgb;
+
+      &hwlist.qlxgbe;
+
+      &hwlist.qlxge;
+
+      &hwlist.re;
+
+      &hwlist.rl;
+
+      &hwlist.rue;
+
+      &hwlist.sf;
+
+      &hwlist.sfxge;
+
+      &hwlist.sge;
+
+      &hwlist.sis;
+
+      &hwlist.sk;
+
+      &hwlist.smsc;
+
+      &hwlist.sn;
+
+      &hwlist.ste;
+
+      &hwlist.stge;
+
+      &hwlist.ti;
+
+      &hwlist.tl;
+
+      <para>[&arch.amd64;, &arch.i386;] SMC 83c17x
+	(EPIC)-based Ethernet NICs (&man.tx.4; driver)</para>
+
+      &hwlist.txp;
+
+      &hwlist.udav;
+
+      &hwlist.urndis;
+
+      &hwlist.vge;
+
+      &hwlist.vr;
+
+      &hwlist.vte;
+
+      &hwlist.vx;
+
+      &hwlist.wb;
+
+      &hwlist.xe;
+
+      &hwlist.xl;
+
+    </sect2>
+
+    <sect2 xml:id="fddi">
+      <title>FDDI Interfaces</title>
+
+      <para>[&arch.i386;] DEC DEFPA PCI (&man.fpa.4; driver)</para>
+
+      <para>[&arch.i386;] DEC DEFEA EISA (&man.fpa.4; driver)</para>
+    </sect2>
+
+    <sect2 xml:id="wlan">
+      <title>Wireless Network Interfaces</title>
+
+      <para>[&arch.amd64;, &arch.i386;] Cisco/Aironet
+	802.11b wireless adapters (&man.an.4; driver)</para>
+
+      &hwlist.ath;
+
+      &hwlist.bwi;
+
+      &hwlist.bwn;
+
+      <para>[&arch.i386;, &arch.amd64;] Intel PRO/Wireless 2100
+	MiniPCI network adapter (&man.ipw.4; driver)</para>
+
+      <para>[&arch.i386;, &arch.amd64;] Intel PRO/Wireless
+	2200BG/2915ABG MiniPCI and 2225BG PCI network adapters
+	(&man.iwi.4; driver)</para>
+
+      <para>[&arch.i386;, &arch.amd64;] Intel Dual Band Wireless AC
+	3160/7260/7265 IEEE 802.11ac network adapters (&man.iwm.4;
+	driver)</para>
+
+      <para>[&arch.i386;, &arch.amd64;] Intel Wireless WiFi Link
+	4965AGN IEEE 802.11n PCI network adapters
+	(&man.iwn.4; driver)</para>
+
+      <para>[&arch.i386;, &arch.amd64;] Marvell Libertas IEEE
+	802.11b/g PCI network adapters (&man.malo.4; driver)</para>
+
+      <para>Marvell 88W8363 IEEE 802.11n wireless network
+	adapters (&man.mwl.4; driver)</para>
+
+      &hwlist.otus;
+
+      &hwlist.ral;
+
+      &hwlist.rsu;
+
+      <para>Realtek RTL8192C, RTL8188E, RTL8812A and RTL8821A based
+	PCIe IEEE 802.11b/g/n wireless network adapters (&man.rtwn.4;
+	driver)</para>
+
+      &hwlist.rum;
+
+      &hwlist.run;
+
+      &hwlist.uath;
+
+      &hwlist.upgt;
+
+      &hwlist.ural;
+
+      &hwlist.urtw;
+
+      <para>[&arch.amd64;, &arch.i386;] Lucent
+	Technologies WaveLAN/IEEE 802.11b wireless network adapters
+	and workalikes using the Lucent Hermes, Intersil PRISM-II,
+	Intersil PRISM-2.5, Intersil Prism-3, and Symbol Spectrum24
+	chipsets (&man.wi.4; driver)</para>
+
+      <para>[&arch.i386;, &arch.amd64;] Intel PRO/Wireless 3945ABG
+	MiniPCI network adapters (&man.wpi.4; driver)</para>
+
+      &hwlist.zyd;
+    </sect2>
+
+    <sect2 xml:id="misc-network">
+      <title>Miscellaneous Networks</title>
+
+      &hwlist.ce;
+
+      &hwlist.cx;
+
+      &hwlist.cp;
+
+      &hwlist.ctau;
+    </sect2>
+
+    <sect2 xml:id="serial">
+      <title>Serial Interfaces</title>
+
+      <para>[&arch.amd64;, &arch.i386;] <quote>PC standard</quote>
+	8250, 16450, and 16550-based serial ports (&man.sio.4;
+	driver)</para>
+
+      &hwlist.uart;
+
+      &hwlist.scc;
+
+      <para>[&arch.amd64;, &arch.i386;] AST 4 port serial card using
+	shared IRQ</para>
+
+      <itemizedlist>
+	<listitem>
+	  <para>ARNET 8 port serial card using shared IRQ</para>
+	</listitem>
+
+	<listitem>
+	  <para>ARNET (now Digiboard) Sync 570/i high-speed
+	    serial</para>
+	</listitem>
+      </itemizedlist>
+
+      <para>[&arch.i386;] Boca multi-port serial cards</para>
+
+      <itemizedlist>
+	<listitem>
+	  <para>Boca BB1004 4-Port serial card (Modems
+	    <emphasis>not</emphasis> supported)</para>
+	</listitem>
+
+	<listitem>
+	  <para>Boca IOAT66 6-Port serial card (Modems
+	    supported)</para>
+	</listitem>
+
+	<listitem>
+	  <para>Boca BB1008 8-Port serial card (Modems
+	    <emphasis>not</emphasis> supported)</para>
+	</listitem>
+
+	<listitem>
+	  <para>Boca BB2016 16-Port serial card (Modems
+	    supported)</para>
+	</listitem>
+      </itemizedlist>
+
+      <para>[&arch.i386;] Comtrol Rocketport card (&man.rp.4;
+	driver)</para>
+
+      <para>[&arch.i386;] Cyclades Cyclom-Y serial board (&man.cy.4;
+	driver)</para>
+
+      <para>[&arch.i386;] STB 4 port card using shared IRQ</para>
+
+      <para>[&arch.amd64;, &arch.i386;] PCI-Based multi-port serial
+	boards (&man.puc.4; driver)</para>
+
+      <itemizedlist>
+	<listitem>
+	  <para>[&arch.amd64;, &arch.i386;] Actiontech 56K PCI</para>
+	</listitem>
+
+	<listitem>
+	  <para>[&arch.amd64;, &arch.i386;] Avlab Technology, PCI IO
+	    2S and PCI IO 4S</para>
+	</listitem>
+
+	<listitem>
+	  <para>[&arch.amd64;, &arch.i386;] Comtrol RocketPort
+	    550</para>
+	</listitem>
+
+	<listitem>
+	  <para>[&arch.amd64;, &arch.i386;] Decision Computers PCCOM
+	    4-port serial and dual port RS232/422/485</para>
+	</listitem>
+
+	<listitem>
+	  <para>[&arch.amd64;, &arch.i386;] Dolphin Peripherals
+	    4025/4035/4036</para>
+	</listitem>
+
+	<listitem>
+	  <para>[&arch.amd64;, &arch.i386;] IC Book Labs Dreadnought
+	    16x Lite and Pro</para>
+	</listitem>
+
+	<listitem>
+	  <para>[&arch.amd64;, &arch.i386;] Lava Computers
+	    2SP-PCI/DSerial-PCI/Quattro-PCI/Octopus-550</para>
+	</listitem>
+
+	<listitem>
+	  <para>[&arch.amd64;, &arch.i386;] Middle Digital, Weasle
+	    serial port</para>
+	</listitem>
+
+	<listitem>
+	  <para>[&arch.amd64;, &arch.i386;] Moxa Industio CP-114,
+	    Smartio C104H-PCI and C168H/PCI</para>
+	</listitem>
+
+	<listitem>
+	  <para>[&arch.amd64;, &arch.i386;] NEC PK-UG-X001 and
+	    PK-UG-X008</para>
+	</listitem>
+
+	<listitem>
+	  <para>[&arch.amd64;, &arch.i386;] Netmos NM9835
+	    PCI-2S-550</para>
+	</listitem>
+
+	<listitem>
+	  <para>[&arch.amd64;, &arch.i386;] Oxford Semiconductor
+	    OX16PCI954 PCI UART</para>
+	</listitem>
+
+	<listitem>
+	  <para>[&arch.amd64;, &arch.i386;] Syba Tech SD-LAB
+	    PCI-4S2P-550-ECP</para>
+	</listitem>
+
+	<listitem>
+	  <para>[&arch.amd64;, &arch.i386;] SIIG Cyber I/O PCI
+	    16C550/16C650/16C850</para>
+	</listitem>
+
+	<listitem>
+	  <para>[&arch.amd64;, &arch.i386;] SIIG Cyber 2P1S PCI
+	    16C550/16C650/16C850</para>
+	</listitem>
+
+	<listitem>
+	  <para>[&arch.amd64;, &arch.i386;] SIIG Cyber 2S1P PCI
+	    16C550/16C650/16C850</para>
+	</listitem>
+
+	<listitem>
+	  <para>[&arch.amd64;, &arch.i386;] SIIG Cyber 4S PCI
+	    16C550/16C650/16C850</para>
+	</listitem>
+
+	<listitem>
+	  <para>[&arch.amd64;, &arch.i386;] SIIG Cyber Serial (Single
+	    and Dual) PCI 16C550/16C650/16C850</para>
+	</listitem>
+
+	<listitem>
+	  <para>[&arch.amd64;, &arch.i386;] Syba Tech
+	    Ltd. PCI-4S2P-550-ECP</para>
+	</listitem>
+
+	<listitem>
+	  <para>[&arch.amd64;, &arch.i386;] Titan PCI-200H and
+	    PCI-800H</para>
+	</listitem>
+
+	<listitem>
+	  <para>[&arch.amd64;, &arch.i386;] US Robotics (3Com) 3CP5609
+	    modem</para>
+	</listitem>
+
+	<listitem>
+	  <para>[&arch.amd64;, &arch.i386;] VScom PCI-400 and
+	    PCI-800</para>
+	</listitem>
+      </itemizedlist>
+
+      &hwlist.rc;
+
+    </sect2>
+
+    <sect2 xml:id="sound">
+      <title>Sound Devices</title>
+
+      &hwlist.snd.ad1816;
+
+      &hwlist.snd.als4000;
+
+      &hwlist.snd.atiixp;
+
+      &hwlist.snd.audiocs;
+
+      &hwlist.snd.cmi;
+
+      &hwlist.snd.cs4281;
+
+      &hwlist.snd.csa;
+
+      &hwlist.snd.ds1;
+
+      &hwlist.snd.emu10k1;
+
+      &hwlist.snd.emu10kx;
+
+      &hwlist.snd.envy24;
+
+      &hwlist.snd.envy24ht;
+
+      &hwlist.snd.es137x;
+
+      &hwlist.snd.ess;
+
+      &hwlist.snd.fm801;
+
+      &hwlist.snd.gusc;
+
+      &hwlist.snd.hda;
+
+      &hwlist.snd.hdspe;
+
+      &hwlist.snd.ich;
+
+      &hwlist.snd.maestro;
+
+      &hwlist.snd.maestro3;
+
+      &hwlist.snd.mss;
+
+      &hwlist.snd.neomagic;
+
+      &hwlist.snd.sbc;
+
+      &hwlist.snd.solo;
+
+      &hwlist.snd.spicds;
+
+      &hwlist.snd.t4dwave;
+
+      &hwlist.snd.via8233;
+
+      &hwlist.snd.via82c686;
+
+      &hwlist.snd.vibes;
+
+    </sect2>
+
+    <sect2 xml:id="camera">
+      <title>Camera and Video Capture Devices</title>
+
+      &hwlist.bktr;
+
+      <para>[&arch.i386;] Connectix QuickCam</para>
+    </sect2>
+
+    <sect2 xml:id="usb">
+      <title>USB Devices</title>
+
+      <para>[&arch.amd64;, &arch.i386;] A
+	range of USB peripherals are supported; devices known to work
+	are listed in this section.  Owing to the generic nature of
+	most USB devices, with some exceptions any device of a given
+	class will be supported, even if not explicitly listed
+	here.</para>
+
+      <note>
+	<para>[&arch.amd64;, &arch.i386;]
+	  USB Ethernet adapters can be found in the section listing
+	  <link linkend="ethernet">Ethernet
+	    interfaces</link>.</para>
+      </note>
+
+      <note>
+	<para>[&arch.amd64;, &arch.i386;] USB Bluetooth adapters can
+	  be found in <link linkend="bluetooth">Bluetooth</link>
+	  section.</para>
+      </note>
+
+      &hwlist.ohci;
+
+      &hwlist.uhci;
+
+      <para>[&arch.amd64;, &arch.i386;] USB
+	2.0 controllers using the EHCI interface (&man.ehci.4;
+	driver)</para>
+
+      <para>[&arch.amd64;, &arch.i386;] Hubs</para>
+
+      <para>[&arch.amd64;, &arch.i386;] Keyboards (&man.ukbd.4;
+	driver)</para>
+
+      <para>[&arch.amd64;, &arch.i386;] Miscellaneous</para>
+
+      <itemizedlist>
+	<listitem>
+	  <para>Assist Computer Systems PC Camera C-M1</para>
+	</listitem>
+
+	<listitem>
+	  <para>ActiveWire I/O Board</para>
+	</listitem>
+
+	<listitem>
+	  <para>Creative Technology Video Blaster WebCam Plus</para>
+	</listitem>
+
+	<listitem>
+	  <para>D-Link DSB-R100 USB Radio (&man.ufm.4; driver)</para>
+	</listitem>
+
+	<listitem>
+	  <para>Mirunet AlphaCam Plus</para>
+	</listitem>
+      </itemizedlist>
+
+      &hwlist.urio;
+
+      &hwlist.umodem;
+
+      <para>[&arch.amd64;, &arch.i386;] Mice (&man.ums.4;
+	driver)</para>
+
+      &hwlist.ulpt;
+
+      &hwlist.ubsa;
+
+      &hwlist.ubser;
+
+      &hwlist.uftdi;
+
+      &hwlist.uplcom;
+
+      &hwlist.umct;
+
+      &hwlist.umass;
+
+      <para>[&arch.amd64;, &arch.i386;] Audio Devices
+	(&man.uaudio.4; driver)</para>
+
+      &hwlist.uvisor;
+    </sect2>
+
+    <sect2 xml:id="firewire">
+      <title>IEEE 1394 (Firewire) Devices</title>
+
+      &hwlist.fwohci;
+
+      <para>[&arch.amd64;, &arch.i386;, &arch.sparc64;] Serial Bus
+	Protocol 2 (SBP-2) storage devices (&man.sbp.4; driver)</para>
+    </sect2>
+
+    <sect2 xml:id="bluetooth">
+      <title>Bluetooth Devices</title>
+
+      &hwlist.ng.bt3c;
+
+      &hwlist.ng.ubt;
+    </sect2>
+
+    <sect2 xml:id="crypto-accel">
+      <title>Cryptographic Accelerators</title>
+
+      &hwlist.hifn;
+
+      &hwlist.safe;
+
+      &hwlist.ubsec;
+    </sect2>
+
+    <sect2 xml:id="misc">
+      <title>Miscellaneous</title>
+
+      <para>[&arch.amd64;, &arch.i386;] FAX-Modem/PCCARD</para>
+
+      <itemizedlist>
+	<listitem>
+	  <para>MELCO IGM-PCM56K/IGM-PCM56KH</para>
+	</listitem>
+
+	<listitem>
+	  <para>Nokia Card Phone 2.0 (gsm900/dcs1800 HSCSD
+	    terminal)</para>
+	</listitem>
+      </itemizedlist>
+
+      <para>[&arch.amd64;, &arch.i386;] Floppy drives
+	(&man.fdc.4; driver)</para>
+
+      <para>[&arch.amd64;, &arch.i386;] VGA-compatible video cards
+	(&man.vga.4; driver)</para>
+
+      <note>
+	<para>Information regarding specific video cards and
+	  compatibility with <application>Xorg</application> can be
+	  found at <uri
+	    xlink:href="http://www.x.org/">http://www.x.org/</uri>.</para>
+      </note>
+
+      <para>[&arch.amd64;, &arch.i386;] Keyboards including:</para>
+
+      <itemizedlist>
+	<listitem>
+	  <para>[&arch.i386;] AT-style keyboards (&man.atkbd.4;
+	    driver)</para>
+	</listitem>
+
+	<listitem>
+	  <para>[&arch.amd64;, &arch.i386;] PS/2 keyboards
+	    (&man.atkbd.4; driver)</para>
+	</listitem>
+
+	<listitem>
+	  <para>[&arch.amd64;, &arch.i386;]
+	    USB keyboards (&man.ukbd.4; driver)</para>
+	</listitem>
+      </itemizedlist>
+
+      <para>[&arch.amd64;, &arch.i386;]
+	Pointing devices including:</para>
+
+      <itemizedlist>
+	<listitem>
+	  <para>[&arch.amd64;, &arch.i386;] Bus mice and
+	    compatible devices (&man.mse.4; driver)</para>
+	</listitem>
+
+	<listitem>
+	  <para>[&arch.amd64;, &arch.i386;] PS/2 mice and compatible
+	    devices, including many laptop pointing devices
+	    (&man.psm.4; driver)</para>
+	</listitem>
+
+	<listitem>
+	  <para>Serial mice and compatible devices</para>
+	</listitem>
+
+	<listitem>
+	  <para>[&arch.amd64;, &arch.i386;]
+	    USB mice (&man.ums.4; driver)</para>
+	</listitem>
+      </itemizedlist>
+
+      <note>
+	<para>&man.moused.8; has more information on using pointing
+	  devices with &os;.  Information on using pointing devices
+	  with <application>Xorg</application> can be found at <uri
+	    xlink:href="http://www.x.org/">http://www.x.org/</uri>.</para>
+      </note>
+
+      <para>[&arch.amd64;, &arch.i386;] <quote>PC standard</quote>
+	parallel ports (&man.ppc.4; driver)</para>
+
+      <para>[&arch.i386;, &arch.amd64;] PC-compatible joysticks
+	(&man.joy.4; driver)</para>
+
+      <para>[&arch.i386;] PHS Data Communication Card/PCCARD</para>
+
+      <itemizedlist>
+	<listitem>
+	  <para>NTT DoCoMo P-in Comp@ct</para>
+	</listitem>
+
+	<listitem>
+	  <para>Panasonic KX-PH405</para>
+	</listitem>
+
+	<listitem>
+	  <para>SII MC-P200</para>
+	</listitem>
+      </itemizedlist>
+
+      <para>[&arch.i386;] Xilinx XC6200-based reconfigurable hardware
+	cards compatible with the HOT1 from <link
+	  xlink:href="http://www.vcc.com/">Virtual Computers</link>
+	(xrpu driver).</para>
+    </sect2>
+  </sect1>
+</article>
diff --git a/en_US.ISO8859-1/htdocs/releases/12.2R/index.xml b/en_US.ISO8859-1/htdocs/releases/12.2R/index.xml
new file mode 100644
index 0000000000..5e7466ac8b
--- /dev/null
+++ b/en_US.ISO8859-1/htdocs/releases/12.2R/index.xml
@@ -0,0 +1,57 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html PUBLIC "-//FreeBSD//DTD XHTML 1.0 Transitional-Based Extension//EN"
+"http://www.FreeBSD.org/XML/share/sgml/xhtml10-freebsd.dtd" [
+<!ENTITY local.rel "12.2">
+<!ENTITY local.branch.stable "stable/12">
+<!ENTITY local.branch.releng "releng/12.2">
+<!ENTITY title "FreeBSD &local.rel; Release Information">
+]>
+
+<html xmlns="http://www.w3.org/1999/xhtml">
+  <head>
+    <title>&title;</title>
+
+    <cvs:keyword xmlns:cvs="http://www.FreeBSD.org/XML/CVS">$FreeBSD$</cvs:keyword>
+  </head>
+
+  <body class="navinclude.download">
+
+    <h1>Introduction</h1>
+
+    <p>This is the index page for &os;&nbsp;&local.rel;.  For more
+      information about the release engineering process, please see
+      the <a href="&base;/releng/index.html">Release Engineering</a>
+      section of the web site.</p>
+
+    <h1>Detailed Information</h1>
+
+    <p>More detailed information, such as release notes and hardware
+      notes can be found at these pages:</p>
+
+    <a href="&base;/releases/&local.rel;R/schedule.html"
+      >&os;&nbsp;&local.rel;-RELEASE schedule</a><br/>
+
+    <?ignore
+    <a href="&base;/releases/&local.rel;R/signatures.html"
+      >&os;&nbsp;&local.rel;-RELEASE signed checksum files</a><br/>
+
+    <a href="&base;/releases/&local.rel;R/installation.html"
+      >&os;&nbsp;&local.rel;-RELEASE installation information</a><br/>
+
+    <a href="&base;/releases/&local.rel;R/hardware.html"
+      >&os;&nbsp;&local.rel;-RELEASE hardware information</a><br/>
+
+    <a href="&base;/releases/&local.rel;R/relnotes.html"
+      >&os;&nbsp;&local.rel;-RELEASE release notes</a><br/>
+
+    <a href="&base;/releases/&local.rel;R/errata.html"
+      >&os;&nbsp;&local.rel;-RELEASE errata</a><br/>
+
+    <a href="&base;/releases/&local.rel;R/readme.html"
+      >&os;&nbsp;&local.rel;-RELEASE readme</a><br/>
+
+    <a href="&base;/releases/&local.rel;R/todo.html">&os; Release
+      Engineering TODO Page</a><br/>
+    ?>
+  </body>
+</html>
diff --git a/en_US.ISO8859-1/htdocs/releases/12.2R/installation/Makefile b/en_US.ISO8859-1/htdocs/releases/12.2R/installation/Makefile
new file mode 100644
index 0000000000..5d7fbee29d
--- /dev/null
+++ b/en_US.ISO8859-1/htdocs/releases/12.2R/installation/Makefile
@@ -0,0 +1,12 @@
+# $FreeBSD$
+
+.if exists(../Makefile.inc)
+.include "../Makefile.inc"
+.endif
+
+DOC=			installation
+FORMATS?=		html txt
+INSTALL_COMPRESSED?=	gz
+INSTALL_ONLY_COMPRESSED=
+
+.include "${DOC_PREFIX}/share/mk/doc.project.mk"
diff --git a/en_US.ISO8859-1/htdocs/releases/12.2R/installation/installation.xml b/en_US.ISO8859-1/htdocs/releases/12.2R/installation/installation.xml
new file mode 100644
index 0000000000..a0c6022a32
--- /dev/null
+++ b/en_US.ISO8859-1/htdocs/releases/12.2R/installation/installation.xml
@@ -0,0 +1,126 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V5.0-Based Extension//EN"
+"../../../../../share/xml/freebsd50.dtd" [
+<!ENTITY % release PUBLIC "-//FreeBSD//ENTITIES Release Specification//EN" "../share/xml/release.ent">
+ %release;
+<!ENTITY local.rel "12.1">
+]>
+<article xmlns="http://docbook.org/ns/docbook"
+  xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
+  xml:id="top">
+
+  <info>
+    <title>&os; &release.current; Installation
+      Instructions</title>
+
+    <author>
+      <orgname>The &os; Project</orgname>
+    </author>
+
+    <pubdate>$FreeBSD$</pubdate>
+
+    <copyright>
+      <year>2020</year>
+      <holder role="mailto:doc@FreeBSD.org">The &os; Documentation
+	Project</holder>
+    </copyright>
+
+    <legalnotice xml:id="trademarks" role="trademarks">
+      &tm-attrib.freebsd;
+      &tm-attrib.intel;
+      &tm-attrib.sparc;
+      &tm-attrib.general;
+    </legalnotice>
+
+    <abstract>
+      <para>This article gives some brief instructions on installing
+	&os; &release.current; and upgrading the systems running
+	earlier releases.</para>
+    </abstract>
+  </info>
+
+  <sect1 xml:id="install">
+    <title>Installing &os;</title>
+
+    <para>The <uri
+	xlink:href="&url.books.handbook;/bsdinstall.html">Installing
+	&os;</uri> chapter of the <uri
+	xlink:href="&url.books.handbook;/">&os; Handbook</uri>
+      provides more in-depth information about the installation
+      program itself, including a guided walk-through with
+      screenshots.</para>
+  </sect1>
+
+  <sect1 xml:id="upgrade">
+    <title>Upgrading &os;</title>
+
+    <para>If you are upgrading from a previous release of &os;, please
+      read <uri
+      xlink:href="http://www.FreeBSD.org/releases/&local.rel;R/relnotes.html#upgrade">upgrading
+      section in the Release Notes</uri> for notable
+      incompatibilities carefully.</para>
+
+    <sect2 xml:id="upgrade-source">
+      <title>Upgrading from Source</title>
+
+      <para>The procedure for doing a source code based update is
+	described in <uri
+	  xlink:href="&url.books.handbook;/makeworld.html">Updating
+	  &os; from Source</uri>.</para>
+
+      <para>For SVN use the <filename>releng/&local.rel;</filename>
+	branch which will be where any upcoming Security Advisories or
+	Errata Notices will be applied.</para>
+    </sect2>
+
+    <sect2 xml:id="upgrade-binary">
+      <title>Upgrading Using <quote>&os; Update</quote></title>
+
+      <para>The &man.freebsd-update.8; utility supports binary
+	upgrades of &arch.i386; and &arch.amd64; systems running
+	earlier FreeBSD releases.  Systems running
+	<literal>11.3-RELEASE</literal> or
+	<literal>12.0-RELEASE</literal> can upgrade as follows:</para>
+
+      <screen>&prompt.root; freebsd-update fetch
+&prompt.root; freebsd-update install</screen>
+
+      <para>Now the &man.freebsd-update.8; utility can fetch bits
+	belonging to &release.current;.  During this process
+	&man.freebsd-update.8; will ask for help in merging
+	configuration files.</para>
+
+      <screen>&prompt.root; freebsd-update upgrade -r &local.rel;-RELEASE</screen>
+
+      <screen>&prompt.root; freebsd-update install</screen>
+
+      <para>The system must now be rebooted with the newly installed
+	kernel before the non-kernel components are updated.</para>
+
+      <screen>&prompt.root; shutdown -r now</screen>
+
+      <para>After rebooting, &man.freebsd-update.8; needs to be run
+	again to install the new userland components:</para>
+
+      <screen>&prompt.root; freebsd-update install</screen>
+
+      <para>At this point, users of systems being upgraded from
+	earlier &os; releases will be prompted by
+	&man.freebsd-update.8; to rebuild all third-party applications
+	(e.g., ports installed from the ports tree) due to updates in
+	system libraries.</para>
+
+      <para>After updating installed third-party applications (and
+	again, only if &man.freebsd-update.8; printed a message
+	indicating that this was necessary), run
+	&man.freebsd-update.8; again so that it can delete the old (no
+	longer used) system libraries:</para>
+
+      <screen>&prompt.root; freebsd-update install</screen>
+
+      <para>Finally, reboot into &release.current;</para>
+
+      <screen>&prompt.root; shutdown -r now</screen>
+    </sect2>
+  </sect1>
+</article>
diff --git a/en_US.ISO8859-1/htdocs/releases/12.2R/readme/Makefile b/en_US.ISO8859-1/htdocs/releases/12.2R/readme/Makefile
new file mode 100644
index 0000000000..3683dfea47
--- /dev/null
+++ b/en_US.ISO8859-1/htdocs/releases/12.2R/readme/Makefile
@@ -0,0 +1,12 @@
+# $FreeBSD$
+
+.if exists(../Makefile.inc)
+.include "../Makefile.inc"
+.endif
+
+DOC=			readme
+FORMATS?=		html txt
+INSTALL_COMPRESSED?=	gz
+INSTALL_ONLY_COMPRESSED=
+
+.include "${DOC_PREFIX}/share/mk/doc.project.mk"
diff --git a/en_US.ISO8859-1/htdocs/releases/12.2R/readme/readme.xml b/en_US.ISO8859-1/htdocs/releases/12.2R/readme/readme.xml
new file mode 100644
index 0000000000..3c0e2c274d
--- /dev/null
+++ b/en_US.ISO8859-1/htdocs/releases/12.2R/readme/readme.xml
@@ -0,0 +1,435 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V5.0-Based Extension//EN"
+"../../../../../share/xml/freebsd50.dtd" [
+<!ENTITY % release PUBLIC "-//FreeBSD//ENTITIES Release Specification//EN" "../share/xml/release.ent">
+ %release;
+]>
+<!--
+     Local Variables:
+     mode: sgml
+     sgml-indent-data: t
+     sgml-omittag: nil
+     sgml-always-quote-attributes: t
+     End:
+-->
+<article xmlns="http://docbook.org/ns/docbook"
+  xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
+
+  <info>
+    <title>&os; &release.current; README</title>
+
+    <author>
+      <orgname>The &os; Project</orgname>
+    </author>
+
+    <pubdate>$FreeBSD$</pubdate>
+
+    <copyright>
+      <year>2000</year>
+      <year>2001</year>
+      <year>2002</year>
+      <year>2003</year>
+      <year>2004</year>
+      <year>2005</year>
+      <year>2006</year>
+      <year>2007</year>
+      <year>2008</year>
+      <year>2009</year>
+      <year>2010</year>
+      <year>2011</year>
+      <year>2012</year>
+      <year>2013</year>
+      <year>2014</year>
+      <year>2015</year>
+      <year>2016</year>
+      <year>2017</year>
+      <year>2018</year>
+      <year>2019</year>
+      <year>2020</year>
+      <holder role="mailto:doc@FreeBSD.org">The &os; Documentation
+	Project</holder>
+    </copyright>
+
+    <legalnotice xml:id="trademarks" role="trademarks">
+      &tm-attrib.freebsd;
+      &tm-attrib.intel;
+      &tm-attrib.opengroup;
+      &tm-attrib.sparc;
+      &tm-attrib.general;
+    </legalnotice>
+
+    <abstract>
+      <para>This document gives a brief introduction to &os;
+	&release.current;.  It includes some information on how to
+	obtain &os;, a listing of various ways to contact the &os;
+	Project, and pointers to some other sources of
+	information.</para>
+    </abstract>
+  </info>
+
+  <sect1 xml:id="intro">
+    <title>Introduction</title>
+
+    <para>This distribution is a &release.type; of &os;
+      &release.current;, the latest point along the &release.branch;
+      branch.</para>
+
+    <sect2>
+      <title>About &os;</title>
+
+      <para>&os; is an operating system based on 4.4 BSD Lite for
+	AMD64 and Intel EM64T based PC hardware (&arch.amd64;), Intel,
+	AMD, Cyrix or NexGen <quote>x86</quote> based PC hardware
+	(&arch.i386;), and &ultrasparc; machines (&arch.sparc64;).
+	Versions for the &arm; (&arch.arm;), &mips; (&arch.mips;), and
+	&powerpc; (&arch.powerpc;) architectures are currently under
+	development as well.  &os; works with a wide variety of
+	peripherals and configurations and can be used for everything
+	from software development to games to Internet Service
+	Provision.</para>
+
+      <para>This release of &os; contains everything you need to run
+	such a system, including full source code for the kernel and
+	all utilities in the base distribution.  With the source
+	distribution installed, you can literally recompile the entire
+	system from scratch with one command, making it ideal for
+	students, researchers, or users who simply want to see how it
+	all works.</para>
+
+      <para>A large collection of third-party ported software (the
+	<quote>Ports Collection</quote>) is also provided to make it
+	easy to obtain and install all your favorite traditional
+	&unix; utilities for &os;.  Each <quote>port</quote> consists
+	of a set of scripts to retrieve, configure, build, and install
+	a piece of software, with a single command.  Over
+	&os.numports; ports, from editors to programming languages to
+	graphical applications, make &os; a powerful and comprehensive
+	operating environment that extends far beyond what's provided
+	by many commercial versions of &unix;.  Most ports are also
+	available as pre-compiled <quote>packages</quote>, which can
+	be quickly installed from the installation program.</para>
+    </sect2>
+
+    <sect2>
+      <title>Target Audience</title>
+
+      <para releasetype="current">This &release.type; is aimed
+	primarily at early adopters and various other users who want
+	to get involved with the ongoing development of &os;.  While
+	the &os; development team tries its best to ensure that each
+	&release.type; works as advertised, &release.branch; is very
+	much a work-in-progress.</para>
+
+      <para releasetype="current">The basic requirements for using
+	this &release.type; are technical proficiency with &os; and an
+	understanding of the ongoing development process of &os;
+	&release.branch; (as discussed on the &a.current;).</para>
+
+      <para releasetype="current">For those more interested in doing
+	business with &os; than in experimenting with new &os;
+	technology, formal releases (such as &release.prev.stable;)
+	are frequently more appropriate.  Releases undergo a period of
+	testing and quality assurance checking to ensure high
+	reliability and dependability.</para>
+
+      <para releasetype="snapshot">This &release.type; is aimed
+	primarily at early adopters and various other users who want
+	to get involved with the ongoing development of &os;.  While
+	the &os; development team tries its best to ensure that each
+	&release.type; works as advertised, &release.branch; is very
+	much a work-in-progress.</para>
+
+      <para releasetype="snapshot">The basic requirements for using
+	this &release.type; are technical proficiency with &os; and an
+	understanding of the ongoing development process of &os;
+	&release.branch; (as discussed on the &a.current;).</para>
+
+      <para releasetype="snapshot">For those more interested in doing
+	business with &os; than in experimenting with new &os;
+	technology, formal releases (such as &release.prev.stable;)
+	are frequently more appropriate.  Releases undergo a period of
+	testing and quality assurance checking to ensure high
+	reliability and dependability.</para>
+
+      <para releasetype="release">This &release.type; of &os; is
+	suitable for all users.  It has undergone a period of testing
+	and quality assurance checking to ensure the highest
+	reliability and dependability.</para>
+    </sect2>
+  </sect1>
+
+  <sect1 xml:id="obtain">
+    <title>Obtaining &os;</title>
+
+    <para>&os; may be obtained in a variety of ways.  This section
+      focuses on those ways that are primarily useful for obtaining a
+      complete &os; distribution, rather than updating an existing
+      installation.</para>
+
+    <sect2>
+      <title>CDROM and DVD</title>
+
+      <para>&os; -RELEASE distributions may be ordered on CDROM or DVD
+	from several publishers.  This is frequently the most
+	convenient way to obtain &os; for new installations, as it
+	provides a convenient way to quickly reinstall the system if
+	necessary.  Some distributions include some of the optional,
+	precompiled <quote>packages</quote> from the &os; Ports
+	Collection, or other extra material.</para>
+
+      <para>A list of the CDROM and DVD publishers known to the
+	project are listed in the <link
+	  xlink:href="&url.books.handbook;/mirrors.html"><quote>Obtaining
+	    &os;</quote></link> appendix to the Handbook.</para>
+    </sect2>
+
+    <sect2>
+      <title>FTP</title>
+
+      <para>You can use FTP to retrieve &os; and any or all of its
+	optional packages from <uri
+	  xlink:href="ftp://ftp.FreeBSD.org/">ftp://ftp.FreeBSD.org/</uri>,
+	which is the official &os; release site, or any of its
+	<quote>mirrors</quote>.</para>
+
+      <para>Lists of locations that mirror &os; can be found in the
+	<link xlink:href="&url.books.handbook;/mirrors-ftp.html">FTP
+	Sites</link> section of the Handbook.
+	Finding a close (in networking terms) mirror from which to
+	download the distribution is highly recommended.</para>
+
+      <para>Additional mirror sites are always welcome.  Contact
+	<email>freebsd-admin@FreeBSD.org</email> for more details on
+	becoming an official mirror site.  You can also find useful
+	information for mirror sites at the <link
+	  xlink:href="&url.articles.hubs;/">Mirroring &os;</link>
+	article.</para>
+
+      <para>Mirrors generally contain the ISO images generally used to
+	create a CDROM of a &os; release.  They usually also contain
+	floppy disk images (for applicable platforms), as well as the
+	files necessary to do an installation over the network.
+	Finally mirrors sites usually contain a set of packages for
+	the most current release.</para>
+    </sect2>
+  </sect1>
+
+  <sect1 xml:id="contacting">
+    <title>Contacting the &os; Project</title>
+
+    <sect2>
+      <title>Email and Mailing Lists</title>
+
+      <para>For any questions or general technical support issues,
+	please send mail to the &a.questions;.</para>
+
+      <para>If you're tracking the &release.branch; development
+	efforts, you <emphasis>must</emphasis> join the &a.current;,
+	in order to keep abreast of recent developments and changes
+	that may affect the way you use and maintain the
+	system.</para>
+
+      <para>Being a largely-volunteer effort, the &os; Project is
+	always happy to have extra hands willing to help&mdash;there
+	are already far more desired enhancements than there is time
+	to implement them.  To contact the developers on technical
+	matters, or with offers of help, please send mail to the
+	&a.hackers;.</para>
+
+      <para>Please note that these mailing lists can experience
+	<emphasis>significant</emphasis> amounts of traffic.  If you
+	have slow or expensive mail access, or are only interested in
+	keeping up with major &os; events, you may find it
+	preferable to subscribe instead to the &a.announce;.</para>
+
+      <para>All of the mailing lists can be freely joined by anyone
+	wishing to do so.  Visit the <link
+	  xlink:href="&url.base;/mailman/listinfo">&os; Mailman Info
+	  Page</link>.  This will give you more information on joining
+	the various lists, accessing archives, etc.  There are
+	a number of mailing lists targeted at special interest groups
+	not mentioned here; more information can be obtained either
+	from the Mailman pages or the <link
+	  xlink:href="&url.base;/support.html#mailing-list">mailing
+	  lists section</link> of the &os; Web site.</para>
+
+      <important>
+	<para>Do <emphasis>not</emphasis> send email to the lists
+	  asking to be subscribed.  Use the Mailman interface
+	  instead.</para>
+      </important>
+    </sect2>
+
+    <sect2>
+      <title>Submitting Problem Reports</title>
+
+      <para>Suggestions, bug reports and contributions of code are
+	always valued&mdash;please do not hesitate to report any
+	problems you may find.  Bug reports with attached fixes are of
+	course even more welcome.</para>
+
+      <para>The preferred method to submit bug reports from a machine
+	with Internet connectivity is to use the
+	<application>Bugzilla</application> bug tracker.
+	<quote>Problem Reports</quote> (PRs) submitted in this way
+	will be filed and their progress tracked; the &os; developers
+	will do their best to respond to all reported bugs as soon as
+	possible.  <link
+	  xlink:href="https://bugs.FreeBSD.org/search/">A list of all
+	  active PRs</link> is available on the &os; Web site; this
+	list is useful to see what potential problems other users have
+	encountered.</para>
+
+      <para>Note that &man.send-pr.1; is deprecated.</para>
+
+      <para>For more information, <link
+	  xlink:href="&url.articles.problem-reports;/"><quote>Writing
+	    &os; Problem Reports</quote></link>, available on the &os;
+	Web site, has a number of helpful hints on writing and
+	submitting effective problem reports.</para>
+    </sect2>
+  </sect1>
+
+  <sect1 xml:id="seealso">
+    <title>Further Reading</title>
+
+    <para>There are many sources of information about &os;; some are
+      included with this distribution, while others are available
+      on-line or in print versions.</para>
+
+    <sect2 xml:id="release-docs">
+      <title>Release Documentation</title>
+
+      <para>A number of other files provide more specific information
+	about this &release.type; distribution.  These files are
+	provided in various formats.  Most distributions will include
+	both ASCII text (<filename>.TXT</filename>) and HTML
+	(<filename>.HTM</filename>) renditions.  Some distributions
+	may also include other formats such as Portable Document
+	Format (<filename>.PDF</filename>).</para>
+
+      <itemizedlist>
+	<listitem>
+	  <para><filename>README.TXT</filename>: This file, which
+	    gives some general information about &os; as well as some
+	    cursory notes about obtaining a distribution.</para>
+	</listitem>
+
+	<listitem>
+	  <para><filename>RELNOTES.TXT</filename>: The release notes,
+	    showing what's new and different in &os; &release.current;
+	    compared to the previous release (&os;
+	    &release.prev;).</para>
+	</listitem>
+
+	<listitem>
+	  <para><filename>HARDWARE.TXT</filename>: The hardware
+	    compatibility list, showing devices with which &os; has
+	    been tested and is known to work.</para>
+	</listitem>
+
+	<listitem>
+	  <para><filename>ERRATA.TXT</filename>: Release errata.
+	    Late-breaking, post-release information can be found in
+	    this file, which is principally applicable to releases (as
+	    opposed to snapshots).  It is important to consult this
+	    file before installing a release of &os;, as it contains
+	    the latest information on problems which have been found
+	    and fixed since the release was created.</para>
+	</listitem>
+      </itemizedlist>
+
+      <para>On platforms that support &man.bsdinstall.8; (currently
+	&arch.amd64;, &arch.i386;, and &arch.sparc64;), these
+	documents are generally available via the Documentation menu
+	during installation.  Once the system is installed, you can
+	revisit this menu by re-running the &man.bsdinstall.8;
+	utility.</para>
+
+      <note>
+	<para>It is extremely important to read the errata for any
+	  given release before installing it, to learn about any
+	  <quote>late-breaking news</quote> or post-release problems.
+	  The errata file accompanying each release (most likely right
+	  next to this file) is already out of date by definition, but
+	  other copies are kept updated on the Internet and should be
+	  consulted as the <quote>current errata</quote> for this
+	  release.  These other copies of the errata are located at
+	  <uri
+	    xlink:href="&url.base;/releases/">&url.base;/releases/</uri>
+	  (as well as any sites which keep up-to-date mirrors of this
+	  location).</para>
+      </note>
+    </sect2>
+
+    <sect2>
+      <title>Manual Pages</title>
+
+      <para>As with almost all &unix; like operating systems, &os;
+	comes with a set of on-line manual pages, accessed through the
+	&man.man.1; command or through the <link
+	  xlink:href="http://www.FreeBSD.org/cgi/man.cgi">hypertext
+	  manual pages gateway</link> on the &os; Web site.  In
+	general, the manual pages provide information on the different
+	commands and APIs available to the &os; user.</para>
+
+      <para>In some cases, manual pages are written to give
+	information on particular topics.  Notable examples of such
+	manual pages are &man.tuning.7; (a guide to performance
+	tuning), &man.security.7; (an introduction to &os; security),
+	and &man.style.9; (a style guide to kernel coding).</para>
+    </sect2>
+
+    <sect2>
+      <title>Books and Articles</title>
+
+      <para>Two highly-useful collections of &os;-related information,
+	maintained by the &os; Project, are the &os; Handbook and &os;
+	FAQ (Frequently Asked Questions document).  On-line versions
+	of the <link
+	  xlink:href="&url.books.handbook;/">Handbook</link> and <link
+	  xlink:href="&url.books.faq;/">FAQ</link> are always
+	available from the <link
+	  xlink:href="&url.base;/docs.html">&os; Documentation
+	  page</link> or its mirrors.  If you install the
+	<filename>doc</filename> distribution set, you can use a Web
+	browser to read the Handbook and FAQ locally.  In particular,
+	note that the Handbook contains a step-by-step guide to
+	installing &os;.</para>
+
+      <para>A number of on-line books and articles, also maintained by
+	the &os; Project, cover more-specialized, &os;-related topics.
+	This material spans a wide range of topics, from effective use
+	of the mailing lists, to dual-booting &os; with other
+	operating systems, to guidelines for new committers.  Like the
+	Handbook and FAQ, these documents are available from the &os;
+	Documentation Page or in the <filename>doc</filename>
+	distribution set.</para>
+
+      <para>A listing of other books and documents about &os; can be
+	found in the <link
+	  xlink:href="&url.books.handbook;/bibliography.html">bibliography</link>
+	of the &os; Handbook.  Because of &os;'s strong &unix;
+	heritage, many other articles and books written for &unix;
+	systems are applicable as well, some of which are also listed
+	in the bibliography.</para>
+    </sect2>
+  </sect1>
+
+  <sect1 xml:id="acknowledgements">
+    <title>Acknowledgments</title>
+
+    <para>&os; represents the cumulative work of many hundreds, if not
+      thousands, of individuals from around the world who have worked
+      countless hours to bring about this &release.type;.  For
+      a complete list of &os; developers and contributors, please see
+      <link
+	xlink:href="&url.articles.contributors;/"><quote>Contributors
+	  to &os;</quote></link> on the &os; Web site or any of its
+      mirrors.</para>
+
+    <para>Special thanks also go to the many thousands of &os; users
+      and testers all over the world, without whom this &release.type;
+      simply would not have been possible.</para>
+  </sect1>
+</article>
diff --git a/en_US.ISO8859-1/htdocs/releases/12.2R/relnotes/Makefile b/en_US.ISO8859-1/htdocs/releases/12.2R/relnotes/Makefile
new file mode 100644
index 0000000000..fd64181e59
--- /dev/null
+++ b/en_US.ISO8859-1/htdocs/releases/12.2R/relnotes/Makefile
@@ -0,0 +1,31 @@
+# $FreeBSD$
+
+.if exists(../Makefile.inc)
+.include "../Makefile.inc"
+.endif
+
+DOC=			relnotes
+FORMATS?=		html txt
+INSTALL_COMPRESSED?=	gz
+INSTALL_ONLY_COMPRESSED=
+
+RELEASEBRANCH!=		grep -o 'release.branch "\([^"]*\)"' \
+			${.CURDIR}/../share/xml/release.ent | \
+			sed 's|[^ ]* "\([^"]*\)"|\1|'
+RELEASEMAILLIST!=	grep -o 'release.maillist "\([^"]*\)"' \
+			${.CURDIR}/../share/xml/release.ent | \
+			sed 's|[^ ]* "\([^"]*\)"|\1|'
+RELEASEURL!=		grep -o 'release.url \"[^\"]*\"' \
+			${.CURDIR}/../share/xml/release.ent | \
+			sed 's|[^ ]* "\([^"]*\)"|\1|'
+
+XSLTPROCFLAGS+=		--param toc.section.depth "'3'"
+XSLTPROCFLAGS+=		--param release.branch "'${RELEASEBRANCH}'"
+XSLTPROCFLAGS+=		--param release.maillist "'${RELEASEMAILLIST}'"
+XSLTPROCFLAGS+=		--param release.url "'${RELEASEURL}'"
+XSLXHTML=	http://www.FreeBSD.org/XML/share/xml/freebsd-xhtml-release.xsl
+
+.PHONY:			${DOC}.parsed.xml
+.PHONY:			${DOC}.html
+
+.include "${DOC_PREFIX}/share/mk/doc.project.mk"
diff --git a/en_US.ISO8859-1/htdocs/releases/12.2R/relnotes/relnotes.xml b/en_US.ISO8859-1/htdocs/releases/12.2R/relnotes/relnotes.xml
new file mode 100644
index 0000000000..d607e6b86a
--- /dev/null
+++ b/en_US.ISO8859-1/htdocs/releases/12.2R/relnotes/relnotes.xml
@@ -0,0 +1,856 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V5.0-Based Extension//EN"
+"../../../../../share/xml/freebsd50.dtd" [
+<!ENTITY % release PUBLIC "-//FreeBSD//ENTITIES Release Specification//EN" "../share/xml/release.ent">
+ %release;
+<!ENTITY % sponsor PUBLIC "-//FreeBSD//ENTITIES Sponsor Specification//EN" "../share/xml/sponsor.ent">
+ %sponsor;
+<!ENTITY % vendor PUBLIC "-//FreeBSD//ENTITIES Vendor Specification//EN" "../share/xml/vendor.ent">
+ %vendor;
+<!ENTITY security SYSTEM "../share/xml/security.xml">
+<!ENTITY errata SYSTEM "../share/xml/errata.xml">
+]>
+<article xmlns="http://docbook.org/ns/docbook"
+  xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
+
+  <info>
+    <title>&os; &release.current; Release Notes</title>
+
+    <author>
+      <orgname>The &os; Project</orgname>
+    </author>
+
+    <pubdate>$FreeBSD$</pubdate>
+    <copyright>
+      <year>2020</year>
+      <holder role="mailto:doc@FreeBSD.org">The &os; Documentation
+	Project</holder>
+    </copyright>
+
+    <legalnotice xml:id="trademarks" role="trademarks">
+      &tm-attrib.freebsd;
+      &tm-attrib.ibm;
+      &tm-attrib.ieee;
+      &tm-attrib.intel;
+      &tm-attrib.sparc;
+      &tm-attrib.general;
+    </legalnotice>
+
+    <abstract>
+      <para>The release notes for &os; &release.current; contain
+	a summary of the changes made to the &os; base system on the
+	&release.branch; development line.  This document lists
+	applicable security advisories that were issued since the last
+	release, as well as significant changes to the &os; kernel and
+	userland.  Some brief remarks on upgrading are also
+	presented.</para>
+    </abstract>
+  </info>
+
+  <sect1 xml:id="intro">
+    <title>Introduction</title>
+
+    <para>This document contains the release notes for &os;
+      &release.current;.  It describes recently added, changed, or
+      deleted features of &os;.  It also provides some notes on
+      upgrading from previous versions of &os;.</para>
+
+    <para releasetype="current">The &release.type; distribution to
+      which these release notes apply represents the latest point
+      along the &release.branch; development branch since
+      &release.branch; was created.  Information regarding pre-built,
+      binary &release.type; distributions along this branch can be
+      found at <uri
+	xlink:href="&release.url;">&release.url;</uri>.</para>
+
+    <para releasetype="snapshot">The &release.type; distribution to
+      which these release notes apply represents a point along the
+      &release.branch; development branch between &release.prev; and
+      the future &release.next;.  Information regarding pre-built,
+      binary &release.type; distributions along this branch can be
+      found at <uri
+	xlink:href="&release.url;">&release.url;</uri>.</para>
+
+    <para releasetype="release">This distribution of &os;
+      &release.current; is a &release.type; distribution.  It can be
+      found at <uri xlink:href="&release.url;">&release.url;</uri> or
+      any of its mirrors.  More information on obtaining this (or
+      other) &release.type; distributions of &os; can be found in the
+      <link
+	xlink:href="&url.books.handbook;/mirrors.html"><quote>Obtaining
+	  &os;</quote> appendix</link> to the <link
+	xlink:href="&url.books.handbook;/">&os;
+	Handbook</link>.</para>
+
+    <para>All users are encouraged to consult the release errata
+      before installing &os;.  The errata document is updated with
+      <quote>late-breaking</quote> information discovered late in the
+      release cycle or after the release.  Typically, it contains
+      information on known bugs, security advisories, and corrections
+      to documentation.  An up-to-date copy of the errata for &os;
+      &release.current; can be found on the &os; Web site.</para>
+
+    <para>This document describes the most user-visible new or changed
+      features in &os; since &release.prev;.  In general, changes
+      described here are unique to the &release.branch; branch unless
+      specifically marked as &merged; features.</para>
+
+    <para>Typical release note items document recent security
+      advisories issued after &release.prev;, new drivers or hardware
+      support, new commands or options, major bug fixes, or
+      contributed software upgrades.  They may also list changes to
+      major ports/packages or release engineering practices.  Clearly
+      the release notes cannot list every single change made to &os;
+      between releases; this document focuses primarily on security
+      advisories, user-visible changes, and major architectural
+      improvements.</para>
+  </sect1>
+
+  <sect1 xml:id="upgrade">
+    <title>Upgrading from Previous Releases of &os;</title>
+
+    <para arch="amd64,i386">Binary upgrades between RELEASE versions
+      (and snapshots of the various security branches) are supported
+      using the &man.freebsd-update.8; utility.  The binary upgrade
+      procedure will update unmodified userland utilities, as well as
+      unmodified GENERIC kernels distributed as a part of an official
+      &os; release.  The &man.freebsd-update.8; utility requires that
+      the host being upgraded have Internet connectivity.</para>
+
+    <para>Source-based upgrades (those based on recompiling the &os;
+      base system from source code) from previous versions are
+      supported, according to the instructions in
+      <filename>/usr/src/UPDATING</filename>.</para>
+
+    <important>
+      <para>Upgrading &os; should only be attempted after backing up
+	<emphasis>all</emphasis> data and configuration files.</para>
+    </important>
+  </sect1>
+
+  <sect1 xml:id="security-errata">
+    <title>Security and Errata</title>
+
+    <para>This section lists the various Security Advisories and
+      Errata Notices since &release.prev;.</para>
+
+    <sect2 xml:id="security">
+      <title>Security Advisories</title>
+
+      <informaltable frame="none" pgwide="1">
+	<tgroup cols="3">
+	  <colspec colwidth="40%"/>
+	  <colspec colwidth="30%"/>
+	  <colspec colwidth="30%"/>
+	  <thead>
+	    <row>
+	      <entry>Advisory</entry>
+	      <entry>Date</entry>
+	      <entry>Topic</entry>
+	    </row>
+	  </thead>
+
+	  <tbody>
+	    <row>
+	      <entry><link
+		  xlink:href="&security.url;/FreeBSD-SA-18:15.bootpd.asc">FreeBSD-SA-18:15.bootpd</link></entry>
+	      <entry>19&nbsp;December&nbsp;2018</entry>
+	      <entry><para>Buffer overflow</para></entry>
+	    </row>
+
+	    <row>
+	      <entry><link
+		  xlink:href="&security.url;/FreeBSD-SA-19:01.syscall.asc">FreeBSD-SA-19:01.syscall</link></entry>
+	      <entry>5&nbsp;February&nbsp;2019</entry>
+	      <entry><para>Kernel data register leak</para></entry>
+	    </row>
+
+	    <row>
+	      <entry><link
+		  xlink:href="&security.url;/FreeBSD-SA-19:02.fd.asc">FreeBSD-SA-19:02.fd</link></entry>
+	      <entry>5&nbsp;February&nbsp;2019</entry>
+	      <entry><para>File description reference count
+		leak</para></entry>
+	    </row>
+
+	    <row>
+	      <entry><link
+		  xlink:href="&security.url;/FreeBSD-SA-19:03.wpa.asc">FreeBSD-SA-19:03.wpa</link></entry>
+	      <entry>14&nbsp;May&nbsp;2019</entry>
+	      <entry><para>Multiple vulnerabilities</para></entry>
+	    </row>
+
+	    <row>
+	      <entry><link
+		  xlink:href="&security.url;/FreeBSD-SA-19:04.ntp.asc">FreeBSD-SA-19:04.ntp</link></entry>
+	      <entry>14&nbsp;May&nbsp;2019</entry>
+	      <entry><para>Authenticated denial of service in
+		&man.ntpd.8;</para></entry>
+	    </row>
+
+	    <row>
+	      <entry><link
+		  xlink:href="&security.url;/FreeBSD-SA-19:05.pf.asc">FreeBSD-SA-19:05.pf</link></entry>
+	      <entry>14&nbsp;May&nbsp;2019</entry>
+	      <entry><para>IPv6 fragment reassembly panic in
+		&man.pf.4;</para></entry>
+	    </row>
+
+	    <row>
+	      <entry><link
+		  xlink:href="&security.url;/FreeBSD-SA-19:06.pf.asc">FreeBSD-SA-19:06.pf</link></entry>
+	      <entry>14&nbsp;May&nbsp;2019</entry>
+	      <entry><para>ICMP/ICMP6 packet filter bypass in
+		&man.pf.4;</para></entry>
+	    </row>
+
+	    <row>
+	      <entry><link
+		  xlink:href="&security.url;/FreeBSD-SA-19:07.mds.asc">FreeBSD-SA-19:07.mds</link></entry>
+	      <entry>14&nbsp;May&nbsp;2019</entry>
+	      <entry><para>Microarchitectural Data
+		Sampling</para></entry>
+	    </row>
+
+	    <row>
+	      <entry><link
+		  xlink:href="&security.url;/FreeBSD-SA-19:08.rack.asc">FreeBSD-SA-19:08.rack</link></entry>
+	      <entry>19&nbsp;June&nbsp;2019</entry>
+	      <entry><para>Resource exhaustion in non-default RACK TCP
+		stack</para></entry>
+	    </row>
+
+	    <row>
+	      <entry><link
+		  xlink:href="&security.url;/FreeBSD-SA-19:09.iconv.asc">FreeBSD-SA-19:09.iconv</link></entry>
+	      <entry>2&nbsp;July&nbsp;2019</entry>
+	      <entry><para>&man.iconv.3; buffer
+		overflow</para></entry>
+	    </row>
+
+	    <row>
+	      <entry><link
+		  xlink:href="&security.url;/FreeBSD-SA-19:10.ufs.asc">FreeBSD-SA-19:10.ufs</link></entry>
+	      <entry>2&nbsp;July&nbsp;2019</entry>
+	      <entry><para>Kernel stack disclosure</para></entry>
+	    </row>
+
+	    <row>
+	      <entry><link
+		  xlink:href="&security.url;/FreeBSD-SA-19:11.cd_ioctl.asc">FreeBSD-SA-19:11.cd_ioctl</link></entry>
+	      <entry>2&nbsp;July&nbsp;2019</entry>
+	      <entry><para>Privilege escalation in
+		&man.cd.4;</para></entry>
+	    </row>
+
+	    <row>
+	      <entry><link
+		  xlink:href="&security.url;/FreeBSD-SA-19:12.telnet.asc">FreeBSD-SA-19:12.telnet</link></entry>
+	      <entry>24&nbsp;July&nbsp;2019</entry>
+	      <entry><para>Multiple vulnerabilities</para></entry>
+	    </row>
+
+	    <row>
+	      <entry><link
+		  xlink:href="&security.url;/FreeBSD-SA-19:13.pts.asc">FreeBSD-SA-19:13.pts</link></entry>
+	      <entry>24&nbsp;July&nbsp;2019</entry>
+	      <entry><para>Write-after-free
+		vulnerability</para></entry>
+	    </row>
+
+	    <row>
+	      <entry><link
+		  xlink:href="&security.url;/FreeBSD-SA-19:15.mqueuefs.asc">FreeBSD-SA-19:15.mqueuefs</link></entry>
+	      <entry>24&nbsp;July&nbsp;2019</entry>
+	      <entry><para>Reference count overflow</para></entry>
+	    </row>
+
+	    <row>
+	      <entry><link
+		  xlink:href="&security.url;/FreeBSD-SA-19:16.bhyve.asc">FreeBSD-SA-19:16.bhyve</link></entry>
+	      <entry>24&nbsp;July&nbsp;2019</entry>
+	      <entry><para>&man.xhci.4; out-of-bounds
+		read</para></entry>
+	    </row>
+
+	    <row>
+	      <entry><link
+		  xlink:href="&security.url;/FreeBSD-SA-19:17.fd.asc">FreeBSD-SA-19:17.fd</link></entry>
+	      <entry>24&nbsp;July&nbsp;2019</entry>
+	      <entry><para>Reference count leak</para></entry>
+	    </row>
+
+	    <row>
+	      <entry><link
+		  xlink:href="&security.url;/FreeBSD-SA-19:18.bzip2.asc">FreeBSD-SA-19:18.bzip2</link></entry>
+	      <entry>6&nbsp;August&nbsp;2019</entry>
+	      <entry><para>Multiple vulnerabilities</para></entry>
+	    </row>
+
+	    <row>
+	      <entry><link
+		  xlink:href="&security.url;/FreeBSD-SA-19:19.mldv2.asc">FreeBSD-SA-19:19.mldv2</link></entry>
+	      <entry>6&nbsp;August&nbsp;2019</entry>
+	      <entry><para>Out-of-bounds memory access</para></entry>
+	    </row>
+
+	    <row>
+	      <entry><link
+		  xlink:href="&security.url;/FreeBSD-SA-19:20.bsnmp.asc">FreeBSD-SA-19:20.bsnmp</link></entry>
+	      <entry>6&nbsp;August&nbsp;2019</entry>
+	      <entry><para>Insufficient message length
+		validation</para></entry>
+	    </row>
+
+	    <row>
+	      <entry><link
+		  xlink:href="&security.url;/FreeBSD-SA-19:21.bhyve.asc">FreeBSD-SA-19:21.bhyve</link></entry>
+	      <entry>6&nbsp;August&nbsp;2019</entry>
+	      <entry><para>Insufficient validation of guest-supplied
+		data</para></entry>
+	    </row>
+
+	    <row>
+	      <entry><link
+		  xlink:href="&security.url;/FreeBSD-SA-19:22.mbuf.asc">FreeBSD-SA-19:22.mbuf</link></entry>
+	      <entry>20&nbsp;August&nbsp;2019</entry>
+	      <entry><para>IPv6 remove
+		denial-of-service</para></entry>
+	    </row>
+
+	    <row>
+	      <entry><link
+		  xlink:href="&security.url;/FreeBSD-SA-19:23.midi.asc">FreeBSD-SA-19:23.midi</link></entry>
+	      <entry>20&nbsp;August&nbsp;2019</entry>
+	      <entry><para>Kernel memory disclosure</para></entry>
+	    </row>
+
+	    <row>
+	      <entry><link
+		  xlink:href="&security.url;/FreeBSD-SA-19:24.mqueuefs.asc">FreeBSD-SA-19:24.mqueuefs</link></entry>
+	      <entry>20&nbsp;August&nbsp;2019</entry>
+	      <entry><para>Reference count overflow</para></entry>
+	    </row>
+	  </tbody>
+	</tgroup>
+      </informaltable>
+    </sect2>
+
+    <sect2 xml:id="errata">
+      <title>Errata Notices</title>
+
+      <informaltable frame="none" pgwide="1">
+	<tgroup cols="3">
+	  <colspec colwidth="40%"/>
+	  <colspec colwidth="30%"/>
+	  <colspec colwidth="30%"/>
+	  <thead>
+	    <row>
+	      <entry>Errata</entry>
+	      <entry>Date</entry>
+	      <entry>Topic</entry>
+	    </row>
+	  </thead>
+
+	  <tbody>
+	    <row>
+	      <entry><link
+		  xlink:href="&security.url;/FreeBSD-EN-19:01.cc_cubic.asc">FreeBSD-EN-19:01.cc_cubic</link></entry>
+	      <entry>9&nbsp;January&nbsp;2019</entry>
+	      <entry><para>Connection stalls with CUBIC congestion
+		control</para></entry>
+	    </row>
+
+	    <row>
+	      <entry><link
+		  xlink:href="&security.url;/FreeBSD-EN-19:02.tcp.asc">FreeBSD-EN-19:02.tcp</link></entry>
+	      <entry>9&nbsp;January&nbsp;2019</entry>
+	      <entry><para>TCP connections may stall and eventually
+		fail in case of packet loss</para></entry>
+	    </row>
+
+	    <row>
+	      <entry><link
+		  xlink:href="&security.url;/FreeBSD-EN-19:03.sqlite.asc">FreeBSD-EN-19:03.sqlite</link></entry>
+	      <entry>9&nbsp;January&nbsp;2019</entry>
+	      <entry><para>sqlite update</para></entry>
+	    </row>
+
+	    <row>
+	      <entry><link
+		  xlink:href="&security.url;/FreeBSD-EN-19:04.tzdata.asc">FreeBSD-EN-19:04.tzdata</link></entry>
+	      <entry>9&nbsp;January&nbsp;2019</entry>
+	      <entry><para>Timezone database information
+		update</para></entry>
+	    </row>
+
+	    <row>
+	      <entry><link
+		  xlink:href="&security.url;/FreeBSD-EN-19:06.dtrace.asc">FreeBSD-EN-19:06.dtrace</link></entry>
+	      <entry>5&nbsp;February&nbsp;2019</entry>
+	      <entry><para>DTrace incompatibility with SMAP-enabled
+		systems</para></entry>
+	    </row>
+
+	    <row>
+	      <entry><link
+		  xlink:href="&security.url;/FreeBSD-EN-19:07.lle.asc">FreeBSD-EN-19:07.lle</link></entry>
+	      <entry>5&nbsp;February&nbsp;2019</entry>
+	      <entry><para>LLE table lookup code race
+		condition</para></entry>
+	    </row>
+
+	    <row>
+	      <entry><link
+		  xlink:href="&security.url;/FreeBSD-EN-19:08.tzdata.asc">FreeBSD-EN-19:08.tzdata</link></entry>
+	      <entry>14&nbsp;May&nbsp;2019</entry>
+	      <entry><para>Timezone database information
+		update</para></entry>
+	    </row>
+
+	    <row>
+	      <entry><link
+		  xlink:href="&security.url;/FreeBSD-EN-19:09.xinstall.asc">FreeBSD-EN-19:09.xinstall</link></entry>
+	      <entry>14&nbsp;May&nbsp;2019</entry>
+	      <entry><para>&man.install.1; broken with partially
+		matching relative paths</para></entry>
+	    </row>
+
+	    <row>
+	      <entry><link
+		  xlink:href="&security.url;/FreeBSD-EN-19:10.scp.asc">FreeBSD-EN-19:10.scp</link></entry>
+	      <entry>14&nbsp;May&nbsp;2019</entry>
+	      <entry><para>Insufficient filename validation in
+		&man.scp.1; client</para></entry>
+	    </row>
+
+	    <row>
+	      <entry><link
+		  xlink:href="&security.url;/FreeBSD-EN-19:11.net.asc">FreeBSD-EN-19:11.net</link></entry>
+	      <entry>19&nbsp;June&nbsp;2019</entry>
+	      <entry><para>Incorrect locking in networking
+		stack</para></entry>
+	    </row>
+
+	    <row>
+	      <entry><link
+		  xlink:href="&security.url;/FreeBSD-EN-19:12.tzdata.asc">FreeBSD-EN-19:12.tzdata</link></entry>
+	      <entry>2&nbsp;July&nbsp;2019</entry>
+	      <entry><para>Timezone database information
+		update</para></entry>
+	    </row>
+
+	    <row>
+	      <entry><link
+		  xlink:href="&security.url;/FreeBSD-EN-19:13.mds.asc">FreeBSD-EN-19:13.mds</link></entry>
+	      <entry>24&nbsp;July&nbsp;2019</entry>
+	      <entry><para>System crash from Intel CPU vulnerability
+		mitigation</para></entry>
+	    </row>
+
+	    <row>
+	      <entry><link
+		  xlink:href="&security.url;/FreeBSD-EN-19:14.epoch.asc">FreeBSD-EN-19:14.epoch</link></entry>
+	      <entry>6&nbsp;August&nbsp;2019</entry>
+	      <entry><para>Incorrect locking</para></entry>
+	    </row>
+
+	    <row>
+	      <entry><link
+		  xlink:href="&security.url;/FreeBSD-EN-19:15.libunwind.asc">FreeBSD-EN-19:15.libunwind</link></entry>
+	      <entry>6&nbsp;August&nbsp;2019</entry>
+	      <entry><para>Incorrect exception handling</para></entry>
+	    </row>
+
+	    <row>
+	      <entry><link
+		  xlink:href="&security.url;/FreeBSD-EN-19:16.bhyve.asc">FreeBSD-EN-19:16.bhyve</link></entry>
+	      <entry>20&nbsp;August&nbsp;2019</entry>
+	      <entry><para>Instruction emulation
+		improvements</para></entry>
+	    </row>
+
+	    <row>
+	      <entry><link
+		  xlink:href="&security.url;/FreeBSD-EN-19:17.ipfw.asc">FreeBSD-EN-19:17.ipfw</link></entry>
+	      <entry>20&nbsp;August&nbsp;2019</entry>
+	      <entry><para>&quot;jail&quot; keyword fix</para></entry>
+	    </row>
+	  </tbody>
+	</tgroup>
+      </informaltable>
+    </sect2>
+  </sect1>
+
+  <sect1 xml:id="userland">
+    <title>Userland</title>
+
+    <para>This section covers changes and additions to userland
+      applications, contributed software, and system utilities.</para>
+
+    <sect2 xml:id="userland-config">
+      <title>Userland Configuration Changes</title>
+
+      <para revision="352094">The <application>gcc</application>
+	<literal>-Werror</literal> flag has been turned off by
+	default.</para>
+    </sect2>
+
+    <sect2 xml:id="userland-programs">
+      <title>Userland Application Changes</title>
+
+      <para revision="345569">The &man.lockf.1; utility has been
+	updated to return <literal>EX_UNAVAILABLE</literal> if the
+	<literal>-n</literal> flag is used and the lock file does not
+	exist.</para>
+
+      <para revision="342705">The &man.ktrdump.8; utility has been
+	updated to include the <literal>-l</literal> flag which
+	enables &quot;live&quot; mode when specified.</para>
+
+      <para revision="343250">The &man.gzip.1; utility has been
+	updated to add <literal>-l</literal> support for &man.xz.1;
+	files.</para>
+
+      <para revision="344688">The &man.trim.8; utility has been added,
+	which deletes content for blocks on flash-based storage
+	devices that use wear-leveling algorithms.</para>
+
+      <para revision="345487">The &man.sh.1; utility has been updated
+	to include a new <literal>pipefail</literal> option, which
+	when set, changes the exit status of a pipeline to the last
+	non-zero exit status of any command in the pipeline.</para>
+
+      <para revision="347752" contrib="sponsor"
+	sponsor="&mellanox;">The &man.mlx5tool.8; utility has been
+	updated to implement firmware update capability for
+	ConnectX-4&reg;, ConnectX-5&reg;, and ConnectX-6&reg;.</para>
+
+      <para revision="348426">The &man.posixshmcontrol.1; utility has
+	been added.</para>
+
+      <para revision="349930">The &man.swapon.8; utility has been
+	updated to invoke <function>BIO_DELETE</function> to trim
+	swap devices if either the <literal>-E</literal> flag is used
+	on the command line, or if the <literal>trimonce</literal>
+	option is included in &man.fstab.5;.</para>
+
+      <para revision="350952">The &man.nvmecontrol.8; utility has been
+	updated to add a new subcommand, <literal>resv</literal>,
+	which is used to handle <acronym>NVMe</acronym>
+	reservations.</para>
+
+      <para revision="351530" contrib="sponsor" sponsor="&ix;">The
+	&man.camcontrol.8; utility has been updated to support block
+	descriptors when using the <literal>modepage</literal>
+	subcommand.</para>
+
+      <para revision="352774">The &man.freebsd-update.8; utility has
+	been updated to include two new commands,
+	<literal>updatesready</literal> and
+	<literal>showconfig</literal>.</para>
+
+      <para revision="352901">The &man.zfs.8; utility has been updated
+	to support the <literal>-v</literal>, <literal>-n</literal>,
+	and <literal>-P</literal> flags together with the
+	<literal>send</literal> subcommand for bookmarks.</para>
+    </sect2>
+
+    <sect2 xml:id="userland-contrib">
+      <title>Contributed Software</title>
+
+      <para revision="343281"><application>BearSSL</application> has
+	been imported to the base system.</para>
+
+      <para revision="344884">The &man.ntpd.8; suite of utilities have
+	been updated to version 4.2.8p13.</para>
+
+      <para revision="346986">The &man.tcpdump.1; utility has been
+	updated to disable &man.capsicum.4; support when the
+	<literal>-E</literal> flag is used.</para>
+
+      <para revision="346987">The &man.bsnmpd.1; utility has been
+	updated to include <acronym>IPv6</acronym> transport
+	support.</para>
+
+      <para revision="349523">The &man.libarchive.3; library has
+	been updated to version 3.4.0.</para>
+
+      <para revision="350256">The <application>clang</application>,
+	<application>llvm</application>,
+	<application>lld</application>,
+	<application>lldb</application>,
+	<application>compiler-rt</application> utilities and
+	<application>libc++</application> have been updated to version
+	8.0.1.</para>
+
+      <para revision="350297" contrib="sponsor" sponsor="&ff;">The
+	<application>lld</application> linker has been enabled by
+	default for &arch.i386;.</para>
+
+      <para revision="350634">The
+	<application>bzip2recover</application> utility has been
+	added.</para>
+
+      <para revision="351007">The &man.bzip2.1; utility has been
+	updated to version 1.0.8.</para>
+
+      <para revision="351243">Warnings have been added for
+	<application>Kerberos</application> <acronym>GSS</acronym>
+	algorithms deprecated in <acronym>RFC</acronym>8221 and
+	<acronym>RFC</acronym>8429.</para>
+
+      <para revision="351390">The &man.mandoc.1; utility has been
+	updated to the 2019-07-23 snapshot.</para>
+
+      <para revision="351611">The <acronym>WPA</acronym> utilities
+	have been updated to version 2.9.</para>
+
+      <para revision="352192"><application>OpenSSL</application> has
+	been updated to version 1.1.1d.</para>
+
+      <para revision="352353">The timezone database files have been
+	updated to version 2019c.</para>
+    </sect2>
+
+    <sect2 xml:id="userland-deprecated-programs">
+      <title>Deprecated Applications</title>
+
+      <para revision="340444">The &man.ctm.1; utility has been marked
+	as deprecated, and has been removed in &os;&nbsp;13.0.</para>
+
+      <para revision="343940">The &man.timed.8; utility has been
+	marked as deprecated, and has been removed in
+	&os;&nbsp;13.0.</para>
+    </sect2>
+
+    <sect2 xml:id="userland-libraries">
+      <title>Runtime Libraries and API</title>
+
+      <para revision="346331">The <literal>libomp</literal> library
+	has been added.</para>
+    </sect2>
+  </sect1>
+
+  <sect1 xml:id="kernel">
+    <title>Kernel</title>
+
+    <para>This section covers changes to kernel configurations, system
+      tuning, and system control parameters that are not otherwise
+      categorized.</para>
+
+    <sect2 xml:id="kernel-general">
+      <title>General Kernel Changes</title>
+
+      <para revision="343083" contrib="sponsor"
+	sponsor="&modirum;">The kernel will now log the &man.jail.8;
+	<acronym>ID</acronym> when logging a process exit.  The
+	&man.jail.8; <acronym>ID</acronym> <literal>0</literal>
+	represents processes that are not jailed.</para>
+
+      <para revision="343735">The <filename>pci_vendors</filename>
+	list has been updated to version 2019.01.29.</para>
+    </sect2>
+  </sect1>
+
+  <sect1 xml:id="drivers">
+    <title>Devices and Drivers</title>
+
+    <para>This section covers changes and additions to devices and
+      device drivers since &release.prev;.</para>
+
+    <sect2 xml:id="drivers-device">
+      <title>Device Drivers</title>
+
+      <para revision="340190" contrib="sponsor"
+	sponsor="&panzura;">The &man.ichwd.4; driver has been updated
+	to include support for <acronym>TCO</acronym> watchdog timers
+	in the Lewisburg <acronym>PCH</acronym> (C620) chipset.</para>
+
+      <para revision="340446">The &man.amdsmn.4; and &man.amdtemp.4;
+	drivers have been updated to support Ryzen&trade; 2 host
+	bridges.</para>
+
+      <para revision="340447">The &man.amdtemp.4; driver has been
+	updated to correct temperature reporting for the AMD&reg;
+	2990WX.</para>
+
+      <para revision="342835">The &man.rtwn.pci.4; driver has been
+	added for the RTL8188EE chipset.</para>
+
+      <para revision="351246">The &man.crypto.4; driver has been
+	updated to print warnings for deprecated algorithms.</para>
+
+      <para revision="351536">The &man.ntb.hw.amd.4; driver has been
+	added, providing support for the AMD&reg; Non-Transparent
+	Bridge.</para>
+
+      <para revision="351914">The &man.nvme.4; driver has been updated
+	to support suspend/resume for <acronym>PCI</acronym>
+	attachment.</para>
+
+      <para revision="351942" contrib="sponsor" sponsor="&hp;">The
+	&man.cdceem.4; driver has been added, supporting virtual
+	<acronym>USB</acronym> network cards provided by
+	<acronym>iLO</acronym>&nbsp;5, found in new
+	HPE&reg;&nbsp;Proliant&trade; servers.</para>
+
+      <para revision="352351" contrib="sponsor" sponsor="&ff;">The
+	&man.fusefs.5; driver has been overhauled, implementing new
+	features and performance improvements.</para>
+
+      <para revision="352761">The &man.mpr.4; and &man.mps.4; drivers
+	have been updated with stability fixes.</para>
+
+      <para revision="352761">As result of converting &man.mps.4; to
+	use <function>atomic_swap_64</function>, it is now disabled on
+	32-bit &arch.powerpc; and &arch.mips;.</para>
+    </sect2>
+  </sect1>
+
+  <sect1 xml:id="storage">
+    <title>Storage</title>
+
+    <para>This section covers changes and additions to file systems
+      and other storage subsystems, both local and networked.</para>
+
+    <sect2 xml:id="storage-general">
+      <title>General Storage</title>
+
+      <para revision="347384" contrib="sponsor"
+	sponsor="&multiplay;">The &man.camcontrol.8; utility has been
+	updated to add <acronym>ATA</acronym> power mode
+	support.</para>
+
+      <para revision="348587">Deprecation warnings have been added for
+	weaker algorithms when creating &man.geli.8; providers.</para>
+
+      <para revision="r349832">The &man.cam.4; subsystem has been
+	updated to improve <acronym>AHCI</acronym> enclosure
+	management and <acronym>SES</acronym> interoperation.</para>
+    </sect2>
+  </sect1>
+
+  <sect1 xml:id="boot">
+    <title>Boot Loader Changes</title>
+
+    <para>This section covers the boot loader, boot menu, and other
+      boot-related changes.</para>
+
+    <sect2 xml:id="boot-loader">
+      <title>Boot Loader Changes</title>
+
+      <para revision="342683">The &man.loader.8; has been update to
+	allow booting from <acronym>ZFS</acronym> datasets with the
+	<literal>large_dnode</literal> feature flag enabled.</para>
+
+      <para revision="351384">The &man.loader.8; has been updated to
+	support the <literal>com.delphix:removing</literal>
+	<acronym>ZFS</acronym> &man.zpool-features.7; flag.</para>
+    </sect2>
+  </sect1>
+
+  <sect1 xml:id="network">
+    <title>Networking</title>
+
+    <para>This section describes changes that affect networking in
+      &os;.</para>
+
+    <sect2 xml:id="network-general">
+      <title>General Network</title>
+
+      <para revision="344667">The &man.ipfw.8; utility has been
+	updated to fix showing headers outside of &quot;all&quot;
+	when executing <literal>ipfw table list</literal>.</para>
+
+      <para revision="346200" contrib="sponsor"
+	sponsor="&yandex;">Support for <acronym>NAT64</acronym>
+	<acronym>CLAT</acronym> has been added, as defined in
+	<acronym>RFC</acronym>6877.</para>
+
+      <para revision="347110" contrib="sponsor"
+	sponsor="&netflix;">The
+	<literal>net.inet.tcp.rexmit_initial</literal> &man.sysctl.8;
+	has been added, used for setting
+	<literal>RTO.Initial</literal>, used by
+	<acronym>TCP</acronym>.</para>
+
+      <para revision="348233">Support for
+	<acronym>GRE</acronym>-in-<acronym>UDP</acronym> encapsulation
+	has been added, as defined in
+	<acronym>RFC</acronym>8086.</para>
+    </sect2>
+  </sect1>
+
+  <sect1 xml:id="ports">
+    <title>Ports Collection and Package Infrastructure</title>
+
+    <para>This section covers changes to the &os;&nbsp;Ports
+      Collection, package infrastructure, and package maintenance and
+      installation tools.</para>
+
+    <sect2 xml:id="ports-packages ">
+      <title>Packaging Changes</title>
+
+      <para>The &man.pkg.8; utility has been updated to version
+	1.12.0.</para>
+
+      <para>The <application>GNOME</application> desktop environment
+	has been updated to version 3.28.</para>
+
+      <para>The <application>KDE</application> desktop environment
+	has been updated to version 5.16.5.19.08.1.</para>
+    </sect2>
+  </sect1>
+
+  <sect1 xml:id="future-releases">
+    <title>General Notes Regarding Future &os; Releases</title>
+
+    <sect2 xml:id="future-releases-cputype">
+      <title>Default <varname>CPUTYPE</varname> Change</title>
+
+      <para>Starting with &os;-13.0, the default
+	<varname>CPUTYPE</varname> for the &arch.i386;
+	architecture will change from <literal>486</literal> to
+	<literal>686</literal>.</para>
+
+      <para>This means that, by default, binaries produced will
+	require a 686-class <acronym>CPU</acronym>, including but
+	not limited to binaries provided by the &os;&nbsp;Release
+	Engineering team.  &os;&nbsp;13.0 will continue to support
+	older <acronym>CPU</acronym>s, however users needing this
+	functionality will need to build their own releases for
+	official support.</para>
+
+      <para>As the primary use for i486 and i586
+	<acronym>CPU</acronym>s is generally in the embedded market,
+	the general end-user impact is expected to be minimal, as new
+	hardware with these <acronym>CPU</acronym> types has long
+	faded, and much of the deployed base of such systems is
+	nearing retirement age, statistically.</para>
+
+      <para>There were several factors taken into account for this
+	change.  For example, i486 does not have 64-bit atomics, and
+	while they can be emulated in the kernel, they cannot be
+	emulated in the userland.  Additionally, the 32-bit amd64
+	libraries have been i686 since their inception.</para>
+
+      <para>As the majority of 32-bit testing is done by developers
+	using the lib32 libraries on 64-bit hardware with the
+	<varname>COMPAT_FREEBSD32</varname> option in the kernel,
+	this change ensures better coverage and user experience.
+	This also aligns with what the majority of &linux;
+	distributions have been doing for quite some time.</para>
+
+      <para>This is expected to be the final bump of the default
+	<varname>CPUTYPE</varname> in &arch.i386;.</para>
+
+      <para>
+	<important>
+	  <para>This change does not affect the &os;&nbsp;12.x
+	    series of releases.</para>
+	</important>
+      </para>
+    </sect2>
+  </sect1>
+</article>
diff --git a/en_US.ISO8859-1/htdocs/releases/12.2R/schedule.xml b/en_US.ISO8859-1/htdocs/releases/12.2R/schedule.xml
new file mode 100644
index 0000000000..c246e2fe47
--- /dev/null
+++ b/en_US.ISO8859-1/htdocs/releases/12.2R/schedule.xml
@@ -0,0 +1,172 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html PUBLIC "-//FreeBSD//DTD XHTML 1.0 Transitional-Based Extension//EN"
+"http://www.FreeBSD.org/XML/share/sgml/xhtml10-freebsd.dtd" [
+<!ENTITY local.rel "12.2">
+<!ENTITY local.branch.stable "stable/12">
+<!ENTITY local.branch.releng "releng/12.2">
+<!ENTITY title "FreeBSD &local.rel; Release Process">
+<!ENTITY % beta.local.where "IGNORE">
+<!ENTITY % beta2.local.where "IGNORE">
+]>
+
+<html xmlns="http://www.w3.org/1999/xhtml">
+  <head>
+    <title>&title;</title>
+
+    <cvs:keyword xmlns:cvs="http://www.FreeBSD.org/XML/CVS">$FreeBSD$</cvs:keyword>
+  </head>
+
+  <body class="navinclude.download">
+
+    <h1>Introduction</h1>
+
+    <p>This is the release schedule for &os;&nbsp;&local.rel;.  For
+      more information about the release engineering process, please
+      see the <a href="&base;/releng/index.html">Release
+	Engineering</a> section of the web site.</p>
+
+    <p>General discussions about the pending release and known issues
+      should be sent to the public <a
+	href="mailto:FreeBSD-stable@FreeBSD.org">freebsd-stable</a>
+      mailing list.</p>
+
+    <?ignore
+    <p><a
+	href="&base;/doc/en_US.ISO8859-1/books/handbook/freebsd-glossary.html#mfc-glossary">MFC</a>
+	requests are no longer being accepted.</p>
+    ?>
+    <?ignore
+    <p><a
+	href="&base;/doc/en_US.ISO8859-1/books/handbook/freebsd-glossary.html#mfc-glossary">MFC</a>
+      requests should be sent to <a href="mailto:re@FreeBSD.org">re@FreeBSD.org</a>.</p>
+    ?>
+
+    &beta.local.where;
+    &beta2.local.where;
+
+    <h1>Schedule</h1>
+
+    <table class="tblbasic">
+      <tr class="heading">
+	<td>Action</td>
+	<td>Expected</td>
+	<td>Actual</td>
+	<td>Description</td>
+      </tr>
+
+      <tr>
+	<td>Initial release schedule announcement</td>
+	<td>-</td>
+	<td>3&nbsp;January&nbsp;2020</td>
+	<td>Release Engineers send announcement email to developers
+	  with a rough schedule.</td>
+      </tr>
+
+      <tr>
+	<td>Release schedule reminder</td>
+	<td>24&nbsp;July&nbsp;2020</td>
+	<td>-</td>
+	<td>Release Engineers send reminder announcement e-mail to
+	  developers with updated schedule.</td>
+      </tr>
+
+      <tr>
+	<td>Code slush begins</td>
+	<td>28&nbsp;August&nbsp;2020</td>
+	<td>-</td>
+	<td>Release Engineers announce that all further commits to the
+	  &local.branch.stable; branch will not require explicit
+	  approval, however new features should be avoided.</td>
+      </tr>
+
+      <tr>
+	<td>&local.branch.releng; branch</td>
+	<td>11&nbsp;September&nbsp;2020</td>
+	<td>-</td>
+	<td>Subversion branch created; future release engineering
+	  proceeds on this branch.</td>
+      </tr>
+
+      <tr>
+	<td>BETA1 builds begin</td>
+	<td>11&nbsp;September&nbsp;2020</td>
+	<td>-</td>
+	<td>First beta test snapshot.</td>
+      </tr>
+
+      <tr>
+	<td>BETA2 builds begin</td>
+	<td>18&nbsp;September&nbsp;2020</td>
+	<td>-</td>
+	<td>Second beta test snapshot.</td>
+      </tr>
+
+      <tr>
+	<td>BETA3 builds begin</td>
+	<td>25&nbsp;September&nbsp;2020</td>
+	<td>-</td>
+	<td>Third beta test snapshot.</td>
+      </tr>
+
+      <tr>
+	<td>RC1 builds begin</td>
+	<td>2&nbsp;October&nbsp;2020</td>
+	<td>-</td>
+	<td>First release candidate.</td>
+      </tr>
+
+      <tr>
+	<td>RC2 builds begin</td>
+	<td>9&nbsp;October&nbsp;2020</td>
+	<td>-</td>
+	<td>Second release candidate.</td>
+      </tr>
+
+      <tr>
+	<td>RC3 builds begin&nbsp;*</td>
+	<td>16&nbsp;October&nbsp;2020</td>
+	<td>-</td>
+	<td>Second release candidate.</td>
+      </tr>
+
+      <tr>
+	<td>RELEASE builds begin</td>
+	<td>23&nbsp;October&nbsp;2020</td>
+	<td>-</td>
+	<td>&local.rel;-RELEASE builds begin.</td>
+      </tr>
+
+      <tr>
+	<td>RELEASE announcement</td>
+	<td>27&nbsp;October&nbsp;2020</td>
+	<td>-</td>
+	<td>&local.rel;-RELEASE press release.</td>
+      </tr>
+
+      <tr>
+	<td>Turn over to the secteam</td>
+	<td>-</td>
+	<td>-</td>
+	<td>&local.branch.releng; branch is handed over to the
+	  &os;&nbsp;Security Officer Team in one or two weeks after
+	  the announcement.</td>
+      </tr>
+    </table>
+
+    <p>&quot;*&quot; indicates &quot;as-needed&quot; items.</p>
+
+    <?ignore
+    <h1>Status / TODO</h1>
+
+    <a href="&base;/releases/&local.rel;R/todo.html">&os; Release
+      Engineering TODO Page</a>
+    ?>
+
+    <h1>Additional Information</h1>
+
+    <ul>
+      <li><a href="&base;/releng/index.html">&os;&nbsp;Release
+	  Engineering website</a></li>
+    </ul>
+  </body>
+</html>
diff --git a/en_US.ISO8859-1/htdocs/releases/12.2R/share/xml/catalog.xml b/en_US.ISO8859-1/htdocs/releases/12.2R/share/xml/catalog.xml
new file mode 100644
index 0000000000..74f8ccd068
--- /dev/null
+++ b/en_US.ISO8859-1/htdocs/releases/12.2R/share/xml/catalog.xml
@@ -0,0 +1,13 @@
+<?xml version="1.0"?>
+<!-- $FreeBSD$ -->
+<catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog">
+  <rewriteSystem systemIdStartString="http://www.FreeBSD.org/release/XML/"
+                 rewritePrefix="../../"/>
+  <rewriteURI uriStartString="http://www.FreeBSD.org/release/XML/"
+              rewritePrefix="../../"/>
+
+  <public publicId="-//FreeBSD//ENTITIES Release Specification//EN" uri="release.ent"/>
+  <public publicId="-//FreeBSD//ENTITIES Sponsor Specification//EN" uri="sponsor.ent"/>
+  <public publicId="-//FreeBSD//ENTITIES Vendor Specification//EN" uri="vendor.ent"/>
+  <public publicId="-//FreeBSD//ENTITIES Auto Generated Device Lists//EN" uri="dev-auto.ent"/>
+</catalog>
diff --git a/en_US.ISO8859-1/htdocs/releases/12.2R/share/xml/errata.xml b/en_US.ISO8859-1/htdocs/releases/12.2R/share/xml/errata.xml
new file mode 100644
index 0000000000..dbbb5aa8b2
--- /dev/null
+++ b/en_US.ISO8859-1/htdocs/releases/12.2R/share/xml/errata.xml
@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!--
+     The FreeBSD Documentation Project
+
+     $FreeBSD$
+-->
+<informaltable frame="none" pgwide="1">
+  <tgroup cols="3">
+    <colspec colwidth="40%"/>
+    <colspec colwidth="30%"/>
+    <colspec colwidth="30%"/>
+    <thead>
+      <row>
+	<entry>Errata</entry>
+	<entry>Date</entry>
+	<entry>Topic</entry>
+      </row>
+    </thead>
+
+    <tbody>
+      <row>
+	<entry>No notices</entry>
+	<entry>&nbsp;</entry>
+	<entry>&nbsp;</entry>
+      </row>
+    </tbody>
+  </tgroup>
+</informaltable>
diff --git a/en_US.ISO8859-1/htdocs/releases/12.2R/share/xml/release.ent b/en_US.ISO8859-1/htdocs/releases/12.2R/share/xml/release.ent
new file mode 100644
index 0000000000..82b909d26f
--- /dev/null
+++ b/en_US.ISO8859-1/htdocs/releases/12.2R/share/xml/release.ent
@@ -0,0 +1,83 @@
+<!-- -*- sgml -*-
+
+     $FreeBSD$
+
+     OS Release Information -->
+
+<!-- Version of the OS we're describing.  This needs to be updated
+     with each new release. -->
+<!ENTITY release.current "12.1-RELEASE">
+
+<!-- The previous version used for comparison in the "What's New"
+     section.  For -CURRENT, we might point back to the last
+     branchpoint. -->
+<!ENTITY release.prev "12.0-RELEASE">
+
+<!-- The previous stable release, useful for pointing user's at the
+     release they SHOULD be running if they don't want the bleeding
+     edge. -->
+<!ENTITY release.prev.stable "11.3-RELEASE">
+
+<!-- The next version to be released, usually used for snapshots. -->
+<!ENTITY release.next "12.2-RELEASE">
+
+<!-- The name of this branch. -->
+<!ENTITY release.branch "12-STABLE">
+
+<!-- The URL for obtaining this version of FreeBSD. -->
+<!ENTITY release.url "https://www.FreeBSD.org/releases/">
+
+<!-- The URL for Security Advisories and Errata Notices. -->
+<!ENTITY security.url "https://www.FreeBSD.org/security/advisories">
+
+<!-- The recommended mailing list to track. -->
+<!ENTITY release.maillist "stable">
+
+<!-- The type of release (usually this will be either "snapshot"
+     or "release" -->
+<!-- WARNING: Do not forget to also change the release type in
+     doc.relnotes.mk when updating this -->
+<!ENTITY release.type "release">
+<!ENTITY % release.type.current  "IGNORE">
+<!ENTITY % release.type.snapshot "IGNORE">
+<!ENTITY % release.type.release "INCLUDE">
+
+<![%release.type.current;[
+<!ENTITY release '&release.current;'>
+]]>
+<![%release.type.snapshot;[
+<!ENTITY release '&release.prev;'>
+]]>
+<![%release.type.release;[
+<!ENTITY release '&release.current;'>
+]]>
+<!ENTITY release ''>
+
+<!-- The manpaths for man page references -->
+<!ENTITY release.man.url "https://www.FreeBSD.org/cgi/man.cgi">
+<!ENTITY release.manpath.xorg          "7.5.1">
+<!ENTITY release.manpath.netbsd        "5.1">
+<!ENTITY release.manpath.freebsd-ports "Ports">
+<!ENTITY release.manpath.freebsd       "12.0-stable">
+
+<!-- Text constants which probably don't need to be changed.-->
+
+<!-- Name of our OS.  This is almost certainly going to remain
+     FreeBSD, but we might want to try to do some other formatting or
+     other fancy markup on it in the future. -->
+<!ENTITY os "FreeBSD">
+
+<!-- Architecture names -->
+<!ENTITY arch.amd64 "amd64">
+<!ENTITY arch.arm "arm">
+<!ENTITY arch.armv6 "armv6">
+<!ENTITY arch.armv7 "armv7">
+<!ENTITY arch.arm64 "aarch64">
+<!ENTITY arch.i386 "i386">
+<!ENTITY arch.mips "mips">
+<!ENTITY arch.powerpc "powerpc">
+<!ENTITY arch.powerpc64 "powerpc64">
+<!ENTITY arch.sparc64 "sparc64">
+
+<!-- The marker for MFCs. -->
+<!ENTITY merged "MERGED">
diff --git a/en_US.ISO8859-1/htdocs/releases/12.2R/share/xml/release.xsl b/en_US.ISO8859-1/htdocs/releases/12.2R/share/xml/release.xsl
new file mode 100644
index 0000000000..f76ae683d8
--- /dev/null
+++ b/en_US.ISO8859-1/htdocs/releases/12.2R/share/xml/release.xsl
@@ -0,0 +1,106 @@
+<?xml version="1.0"?>
+<!-- $FreeBSD$ -->
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+                version='1.0'
+                xmlns="http://www.w3.org/TR/xhtml1/transitional"
+                xmlns:db="http://docbook.org/ns/docbook"
+                exclude-result-prefixes="db">
+
+  <xsl:import href="http://www.FreeBSD.org/XML/share/xml/freebsd-xhtml.xsl"/>
+
+  <xsl:import href="http://www.FreeBSD.org/release/XML/lang/share/xml/release.xsl"/>
+
+  <xsl:param name="release.url"/>
+  <xsl:param name="release.branch"/>
+  <xsl:param name="release.maillist"/>
+
+  <xsl:template name="paragraph">
+    <xsl:param name="class" select="''"/>
+    <xsl:param name="content"/>
+
+    <xsl:variable name="p">
+      <p>
+	<xsl:choose>
+          <xsl:when test="$class != ''">
+            <xsl:call-template name="common.html.attributes">
+              <xsl:with-param name="class" select="$class"/>
+             </xsl:call-template>
+           </xsl:when>
+          <xsl:otherwise>
+            <xsl:call-template name="locale.html.attributes"/>
+           </xsl:otherwise>
+	 </xsl:choose>
+	<xsl:if test="@arch">
+	  <xsl:value-of select="concat('[', @arch, ']')"/>
+	  <xsl:value-of select='" "'/>
+	</xsl:if>
+	<xsl:copy-of select="$content"/>
+	<xsl:value-of select='" "'/>
+	<xsl:if test="@revision">
+	  <xsl:element name="a">
+	    <xsl:attribute name="href">
+	      <xsl:value-of select="concat('http://svn.freebsd.org/viewvc/base?view=revision&#38;revision=', @revision)"/>
+	    </xsl:attribute>
+	    <xsl:value-of select="concat('[r', @revision, ']')"/>
+	  </xsl:element>
+	</xsl:if>
+	<xsl:if test="@contrib">
+	  <xsl:element name="span">
+	    <xsl:attribute name="class">
+	      <xsl:value-of select="'contrib'"/>
+	    </xsl:attribute>
+	    <xsl:choose>
+	      <xsl:when test="@contrib = 'sponsor'">
+		<xsl:if test="@sponsor != ''">
+		  (Sponsored by
+		  <xsl:choose>
+		    <xsl:when test="@sponsorurl != ''">
+		      <xsl:element name="a">
+			<xsl:attribute name="href">
+			  <xsl:value-of select="@sponsorurl"/>
+			</xsl:attribute>
+			<xsl:value-of select="concat(@sponsor, ')')"/>
+		      </xsl:element>
+		    </xsl:when>
+		    <xsl:otherwise>
+		      <xsl:value-of select="concat(@sponsor, ')')"/>
+		    </xsl:otherwise>
+		  </xsl:choose>
+		</xsl:if>
+	      </xsl:when>
+	      <xsl:when test="@contrib = 'vendor'">
+		<xsl:if test="@vendor != ''">
+		  (Contributed / provided by
+		  <xsl:choose>
+		    <xsl:when test="@vendorurl != ''">
+		      <xsl:element name="a">
+			<xsl:attribute name="href">
+			  <xsl:value-of select="@vendorurl"/>
+			</xsl:attribute>
+			<xsl:value-of select="concat(@vendor, ')')"/>
+		      </xsl:element>
+		    </xsl:when>
+		    <xsl:otherwise>
+		      <xsl:value-of select="concat(@vendor, ')')"/>
+		    </xsl:otherwise>
+		  </xsl:choose>
+		</xsl:if>
+	      </xsl:when>
+	    </xsl:choose>
+	  </xsl:element>
+	</xsl:if>
+       </p>
+     </xsl:variable>
+
+    <xsl:choose>
+      <xsl:when test="$html.cleanup != 0">
+	<xsl:call-template name="unwrap.p">
+          <xsl:with-param name="p" select="$p"/>
+	 </xsl:call-template>
+       </xsl:when>
+      <xsl:otherwise>
+	<xsl:copy-of select="$p"/>
+       </xsl:otherwise>
+     </xsl:choose>
+   </xsl:template>
+</xsl:stylesheet>
diff --git a/en_US.ISO8859-1/htdocs/releases/12.2R/share/xml/security.xml b/en_US.ISO8859-1/htdocs/releases/12.2R/share/xml/security.xml
new file mode 100644
index 0000000000..7f56a63207
--- /dev/null
+++ b/en_US.ISO8859-1/htdocs/releases/12.2R/share/xml/security.xml
@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!--
+     The FreeBSD Documentation Project
+
+     $FreeBSD$
+-->
+<informaltable frame="none" pgwide="1">
+  <tgroup cols="3">
+    <colspec colwidth="40%"/>
+    <colspec colwidth="30%"/>
+    <colspec colwidth="30%"/>
+    <thead>
+      <row>
+	<entry>Advisory</entry>
+	<entry>Date</entry>
+	<entry>Topic</entry>
+      </row>
+    </thead>
+
+    <tbody>
+      <row>
+	<entry>No advisories</entry>
+	<entry>&nbsp;</entry>
+	<entry>&nbsp;</entry>
+      </row>
+    </tbody>
+  </tgroup>
+</informaltable>
diff --git a/en_US.ISO8859-1/htdocs/releases/12.2R/share/xml/sponsor.ent b/en_US.ISO8859-1/htdocs/releases/12.2R/share/xml/sponsor.ent
new file mode 100644
index 0000000000..6c959af04b
--- /dev/null
+++ b/en_US.ISO8859-1/htdocs/releases/12.2R/share/xml/sponsor.ent
@@ -0,0 +1,69 @@
+<!-- -*- sgml -*-
+
+     $FreeBSD$
+
+     Sponsors of various works.
+
+     Please keep the entity list sorted alphabetically.
+
+-->
+
+<!ENTITY abt		"ABT Systems, Ltd.">
+<!ENTITY afrl		"AFRL">
+
+<!ENTITY cavium		"Cavium">
+<!ENTITY chelsio	"Chelsio Communications">
+
+<!ENTITY citrix		"Citrix Systems">
+<!ENTITY citrix.rd	"Citrix Systems R&amp;D">
+
+<!ENTITY clusterhq	"ClusterHQ">
+
+<!ENTITY darpa		"DARPA">
+<!ENTITY darpa_afrl	"DARPA, AFRL">
+<!ENTITY dell		"Dell, Inc.">
+<!ENTITY dellemc	"Dell EMC Isilon">
+
+<!ENTITY emcisilon	"EMC / Isilon Storage Division">
+
+<!ENTITY ff		"The&nbsp;&os;&nbsp;Foundation">
+<!ENTITY ff.url		"https://www.FreeBSDFoundation.org/">
+
+<!ENTITY g2inc		"G2, Inc.">
+<!ENTITY gandi		"Gandi.net">
+<!ENTITY google		"Google">
+
+<!ENTITY juniper	"Juniper Networks, Inc.">
+
+<!ENTITY hbsd		"HardenedBSD">
+<!ENTITY hp		"Hewlett Packard Enterprise">
+
+<!ENTITY intelcorp	"Intel Corporation">
+<!ENTITY ix		"iXsystems">
+
+<!ENTITY klara		"Klara Systems">
+
+<!ENTITY limelight	"Limelight Networks">
+<!ENTITY lsi		"LSI">
+
+<!ENTITY mellanox	"Mellanox Technologies">
+<!ENTITY microchip	"Microchip Technology, Inc.">
+<!ENTITY mitail		"MIT Computer Science &amp; Artificial Intelligence Laboratory">
+<!ENTITY modirum	"Modirum MDPay">
+<!ENTITY msostc		"Microsoft Open Source Technology Center">
+<!ENTITY multiplay	"Multiplay">
+
+<!ENTITY netflix	"Netflix">
+<!ENTITY netgate	"Rubicon Communications, LLC (Netgate)">
+<!ENTITY nginx		"Nginx, Inc.">
+<!ENTITY norse		"Norse Corporation">
+
+<!ENTITY panzura	"Panzura">
+
+<!ENTITY sandvine	"Sandvine, Inc.">
+<!ENTITY scaleengine	"ScaleEngine, Inc.">
+<!ENTITY smule		"Smule, Inc.">
+<!ENTITY solarflare	"Solarflare Communications, Inc.">
+<!ENTITY spectralogic	"Spectra Logic">
+
+<!ENTITY yandex		"Yandex LLC">
diff --git a/en_US.ISO8859-1/htdocs/releases/12.2R/share/xml/vendor.ent b/en_US.ISO8859-1/htdocs/releases/12.2R/share/xml/vendor.ent
new file mode 100644
index 0000000000..75c879b71c
--- /dev/null
+++ b/en_US.ISO8859-1/htdocs/releases/12.2R/share/xml/vendor.ent
@@ -0,0 +1,9 @@
+<!-- -*- sgml -*-
+
+     $FreeBSD$
+
+     Vendors and contributors.
+
+     Please keep the entity list sorted alphabetically.
+
+-->
diff --git a/en_US.ISO8859-1/htdocs/releases/12.2R/signatures.xml b/en_US.ISO8859-1/htdocs/releases/12.2R/signatures.xml
new file mode 100644
index 0000000000..84bc2e0174
--- /dev/null
+++ b/en_US.ISO8859-1/htdocs/releases/12.2R/signatures.xml
@@ -0,0 +1,182 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html PUBLIC "-//FreeBSD//DTD XHTML 1.0 Transitional-Based Extension//EN"
+"http://www.FreeBSD.org/XML/share/sgml/xhtml10-freebsd.dtd" [
+<!ENTITY local.rel "12.2">
+<!ENTITY local.branch.name "RELEASE">
+<!ENTITY local.branch.stable "stable/12">
+<!ENTITY local.branch.releng "releng/12.2">
+<!ENTITY title "FreeBSD &local.rel; Release Checksum Signatures">
+<!ENTITY local.rel.sha256 "&base;/releases/&local.rel;R/CHECKSUM.SHA256-&os;-&local.rel;-&local.branch.name;">
+<!ENTITY local.rel.sha512 "&base;/releases/&local.rel;R/CHECKSUM.SHA512-&os;-&local.rel;-&local.branch.name;">
+]>
+
+<html xmlns="http://www.w3.org/1999/xhtml">
+  <head>
+    <title>&title;</title>
+
+    <cvs:keyword xmlns:cvs="http://www.FreeBSD.org/XML/CVS">$FreeBSD$</cvs:keyword>
+  </head>
+
+  <body class="navinclude.download">
+
+    <h1>Signed Checksum Signatures</h1>
+
+    <p>This page contains links to the PGP-signed checksum files for
+      &os;&nbsp;&local.rel;.</p>
+
+    <h1>Installation Image Checksums</h1>
+
+    <table class="tblbasic tblwide tbldownload">
+      <tbody>
+	<tr>
+	  <th>Architecture</th>
+	  <th><tt>SHA512</tt></th>
+	  <th><tt>SHA256</tt></th>
+	</tr>
+	<tr>
+	  <td>amd64 (x86_64)</td>
+	  <td><a href="&local.rel.sha512;-amd64.asc">SHA512</a></td>
+	  <td><a href="&local.rel.sha256;-amd64.asc">SHA256</a></td>
+	</tr>
+	<tr>
+	  <td>i386</td>
+	  <td><a href="&local.rel.sha512;-i386.asc">SHA512</a></td>
+	  <td><a href="&local.rel.sha256;-i386.asc">SHA256</a></td>
+	</tr>
+	<tr>
+	  <td>powerpc</td>
+	  <td><a href="&local.rel.sha512;-powerpc.asc">SHA512</a></td>
+	  <td><a href="&local.rel.sha256;-powerpc.asc">SHA256</a></td>
+	</tr>
+	<tr>
+	  <td>powerpc64</td>
+	  <td><a href="&local.rel.sha512;-powerpc-powerpc64.asc">SHA512</a></td>
+	  <td><a href="&local.rel.sha256;-powerpc-powerpc64.asc">SHA256</a></td>
+	</tr>
+	<tr>
+	  <td>powerpcspe</td>
+	  <td><a href="&local.rel.sha512;-powerpc-powerpcspe.asc">SHA512</a></td>
+	  <td><a href="&local.rel.sha256;-powerpc-powerpcspe.asc">SHA256</a></td>
+	</tr>
+	<tr>
+	  <td>sparc64</td>
+	  <td><a href="&local.rel.sha512;-sparc64.asc">SHA512</a></td>
+	  <td><a href="&local.rel.sha256;-sparc64.asc">SHA256</a></td>
+	</tr>
+	<tr>
+	  <td>aarch64</td>
+	  <td><a href="&local.rel.sha512;-arm64-aarch64.asc">SHA512</a></td>
+	  <td><a href="&local.rel.sha256;-arm64-aarch64.asc">SHA256</a></td>
+	</tr>
+      </tbody>
+    </table>
+
+    <br/>
+
+    <h1>Virtual Machine Image Checksums</h1>
+
+    <table class="tblbasic tblwide tbldownload">
+      <tbody>
+	<tr>
+	  <th>Architecture</th>
+	  <th><tt>SHA512</tt></th>
+	  <th><tt>SHA256</tt></th>
+	</tr>
+	<tr>
+	  <td>amd64 (x86_64)</td>
+	  <td><a href="&local.rel.sha512;-amd64-vm.asc">SHA512</a></td>
+	  <td><a href="&local.rel.sha256;-amd64-vm.asc">SHA256</a></td>
+	</tr>
+	<tr>
+	  <td>i386</td>
+	  <td><a href="&local.rel.sha512;-i386-vm.asc">SHA512</a></td>
+	  <td><a href="&local.rel.sha256;-i386-vm.asc">SHA256</a></td>
+	</tr>
+	<tr>
+	  <td>aarch64</td>
+	  <td><a href="&local.rel.sha512;-arm64-aarch64-vm.asc">SHA512</a></td>
+	  <td><a href="&local.rel.sha256;-arm64-aarch64-vm.asc">SHA256</a></td>
+	</tr>
+      </tbody>
+    </table>
+
+    <br/>
+
+    <h1>SD Card Image Checksums</h1>
+
+    <table class="tblbasic tblwide tbldownload">
+      <tbody>
+	<tr>
+	  <th>Board Name</th>
+	  <th><tt>SHA512</tt></th>
+	  <th><tt>SHA256</tt></th>
+	</tr>
+	<tr>
+	  <td>RPI-B</td>
+	  <td><a href="&local.rel.sha512;-arm-armv6-RPI-B.asc">SHA512</a></td>
+	  <td><a href="&local.rel.sha256;-arm-armv6-RPI-B.asc">SHA256</a></td>
+	</tr>
+	<tr>
+	  <td>BANANAPI</td>
+	  <td><a href="&local.rel.sha512;-arm-armv7-BANANAPI.asc">SHA512</a></td>
+	  <td><a href="&local.rel.sha256;-arm-armv7-BANANAPI.asc">SHA256</a></td>
+	</tr>
+	<tr>
+	  <td>BEAGLEBONE</td>
+	  <td><a href="&local.rel.sha512;-arm-armv7-BEAGLEBONE.asc">SHA512</a></td>
+	  <td><a href="&local.rel.sha256;-arm-armv7-BEAGLEBONE.asc">SHA256</a></td>
+	</tr>
+	<tr>
+	  <td>CUBIEBOARD</td>
+	  <td><a href="&local.rel.sha512;-arm-armv7-CUBIEBOARD.asc">SHA512</a></td>
+	  <td><a href="&local.rel.sha256;-arm-armv7-CUBIEBOARD.asc">SHA256</a></td>
+	</tr>
+	<tr>
+	  <td>CUBIEBOARD2</td>
+	  <td><a href="&local.rel.sha512;-arm-armv7-CUBIEBOARD2.asc">SHA512</a></td>
+	  <td><a href="&local.rel.sha256;-arm-armv7-CUBIEBOARD2.asc">SHA256</a></td>
+	</tr>
+	<tr>
+	  <td>CUBOX/HUMMINGBOARD</td>
+	  <td><a href="&local.rel.sha512;-arm-armv7-CUBOX-HUMMINGBOARD.asc">SHA512</a></td>
+	  <td><a href="&local.rel.sha256;-arm-armv7-CUBOX-HUMMINGBOARD.asc">SHA256</a></td>
+	</tr>
+	<tr>
+	  <td>GENERICSD</td>
+	  <td><a href="&local.rel.sha512;-arm-armv7-GENERICSD.asc">SHA512</a></td>
+	  <td><a href="&local.rel.sha256;-arm-armv7-GENERICSD.asc">SHA256</a></td>
+	</tr>
+	<tr>
+	  <td>PANDABOARD</td>
+	  <td><a href="&local.rel.sha512;-arm-armv7-PANDABOARD.asc">SHA512</a></td>
+	  <td><a href="&local.rel.sha256;-arm-armv7-PANDABOARD.asc">SHA256</a></td>
+	</tr>
+	<tr>
+	  <td>RPI2</td>
+	  <td><a href="&local.rel.sha512;-arm-armv7-RPI2.asc">SHA512</a></td>
+	  <td><a href="&local.rel.sha256;-arm-armv7-RPI2.asc">SHA256</a></td>
+	</tr>
+	<tr>
+	  <td>WANDBOARD</td>
+	  <td><a href="&local.rel.sha512;-arm-armv7-WANDBOARD.asc">SHA512</a></td>
+	  <td><a href="&local.rel.sha256;-arm-armv7-WANDBOARD.asc">SHA256</a></td>
+	</tr>
+	<tr>
+	  <td>RPI3</td>
+	  <td><a href="&local.rel.sha512;-arm64-aarch64-RPI3.asc">SHA512</a></td>
+	  <td><a href="&local.rel.sha256;-arm64-aarch64-RPI3.asc">SHA256</a></td>
+	</tr>
+	<tr>
+	  <td>PINE64</td>
+	  <td><a href="&local.rel.sha512;-arm64-aarch64-PINE64.asc">SHA512</a></td>
+	  <td><a href="&local.rel.sha256;-arm64-aarch64-PINE64.asc">SHA256</a></td>
+	</tr>
+	<tr>
+	  <td>PINE64-LTS</td>
+	  <td><a href="&local.rel.sha512;-arm64-aarch64-PINE64-LTS.asc">SHA512</a></td>
+	  <td><a href="&local.rel.sha256;-arm64-aarch64-PINE64-LTS.asc">SHA256</a></td>
+	</tr>
+      </tbody>
+    </table>
+  </body>
+</html>