From c884b7d4537faefba8ece96906477c9a9b3bb391 Mon Sep 17 00:00:00 2001
From: gjb <gjb@ccf9f872-aa2e-dd11-9fc8-001c23d0bc1f>
Date: Tue, 11 Nov 2014 05:46:10 +0000
Subject: [PATCH] Document incompatibility between bsdconfig(8) and pkg(8) in
 10.1-RELEASE, and provide steps to install the on-disc packages via
 alternative method.

Approved by:	re (implicit)
Sponsored by:	The FreeBSD Foundation


git-svn-id: svn://svn.freebsd.org/base/releng/10.1@274368 ccf9f872-aa2e-dd11-9fc8-001c23d0bc1f
---
 .../doc/en_US.ISO8859-1/errata/article.xml    | 50 +++++++++++++++++++
 1 file changed, 50 insertions(+)

diff --git a/release/doc/en_US.ISO8859-1/errata/article.xml b/release/doc/en_US.ISO8859-1/errata/article.xml
index 71fc9acb5..152344317 100644
--- a/release/doc/en_US.ISO8859-1/errata/article.xml
+++ b/release/doc/en_US.ISO8859-1/errata/article.xml
@@ -175,6 +175,56 @@ boot</screen>
 	    directly.</para>
 	</note>
       </listitem>
+
+      <listitem>
+	<para>Due to an incompatibility between &man.bsdconfig.8;
+	  and &man.pkg.8;&nbsp;version 1.3, packages included on the
+	  &os;&nbsp;dvd installer will not be recognized by
+	  &man.bsdconfig.8;.</para>
+
+	<para>To install packages from the <literal>dvd1.iso</literal>
+	  installer, create the <filename
+	    class="directory">/dist</filename> target directory, and
+	  manually mount the <literal>dvd1.iso</literal>
+	  <acronym>ISO</acronym>:</para>
+
+	<screen>&prompt.root; mkdir -p /dist
+&prompt.root; mount -t cd9660 /dev/<replaceable>cd0</replaceable> /dist</screen>
+
+	<note>
+	  <para>Be sure to use the correct <filename
+	      class="directory">/dev</filename> device path for the
+	    <literal>dvd1.iso</literal> <acronym>ISO</acronym>
+	    installer.</para>
+	</note>
+
+	<para>Next, set <envar>REPOS_DIR</envar> to the path of the
+	  <filename class="directory">repos/</filename> directory
+	  within the installer so &man.pkg.8; will use the correct
+	  repository metadata.</para>
+
+	<para>If using &man.sh.1;:</para>
+
+	<screen>&prompt.root; export REPOS_DIR=/dist/packages/repos</screen>
+
+	<para>If using &man.csh.1;:</para>
+
+	<screen>&prompt.root; setenv REPOS_DIR /dist/packages/repos</screen>
+
+	<note>
+	  <para>Keep in mind that <envar>REPOS_DIR</envar> will need
+	    to be set again after the current shell session is
+	    terminated, if continuing to use the packages provided on
+	    the <literal>dvd1.iso</literal> installer.</para>
+	</note>
+
+	<para>Finally, bootstrap &man.pkg.8; from the
+	  <acronym>ISO</acronym>, and install required
+	  packages:</para>
+
+	<screen>&prompt.root; pkg bootstrap
+&prompt.root; pkg install <replaceable>xorg-server</replaceable> <replaceable>xorg</replaceable> <replaceable>gnome2</replaceable> [...]</screen>
+      </listitem>
     </itemizedlist>
   </sect1>
 
-- 
2.42.0