From ac67398a264abdb2c5f0c51bb51786412343ff4a Mon Sep 17 00:00:00 2001
From: "Bruce A. Mah" <bmah@FreeBSD.org>
Date: Sat, 10 Nov 2001 17:41:02 +0000
Subject: [PATCH] Update ld.so FAQ.  From PR with one markup change.

PR:		31878
Submitted by:	mwlucas@blackhelicopters.org
---
 en_US.ISO8859-1/books/faq/book.sgml | 29 ++++++++++++++++++++++-------
 1 file changed, 22 insertions(+), 7 deletions(-)

diff --git a/en_US.ISO8859-1/books/faq/book.sgml b/en_US.ISO8859-1/books/faq/book.sgml
index 8f08c5e7e7..f87c70df33 100644
--- a/en_US.ISO8859-1/books/faq/book.sgml
+++ b/en_US.ISO8859-1/books/faq/book.sgml
@@ -5032,13 +5032,28 @@ crw-rw-rw-  1 root  wheel   41,   1 Oct 15 22:14 spx</screen>
         </question>
 
         <answer>
-          <para>If you want to run some a.out applications like
-            Netscape Navigator on an Elf'ened machine such as 3.1-R or
-            later, it would need <filename>/usr/libexec/ld.so</filename>
-            and some a.out libs. They are included in the compat22
-            distribution. Use <filename>/stand/sysinstall</filename> or
-            <filename>install.sh</filename> in the compat22 subdirectory
-            and install it. Also read ERRATAs for 3.1-R and 3.2-R.</para>
+          <para>a.out applications like Netscape Navigator require
+            a.out libraries.  A version of FreeBSD built with ELF
+            libraries does not install them by default.  You will get
+            complaints about not having
+            <filename>/usr/libexec/ld.so</filename> if this is the
+            case on your system.  These libraries are available as an
+            add-on in the compat22 distribution.  Use
+            &man.sysinstall.8; to install them.  You can
+            also install them from the FreeBSD source code:</para>
+
+          <screen>&prompt.root; <userinput>cd /usr/src/lib/compat/compat22</userinput>
+&prompt.root; <userinput>make install clean</userinput></screen>
+
+          <para>If you want to install the latest compat22 libraries
+            whenever you run <command>make world</command>, edit
+            <filename>/etc/make.conf</filename> to include
+            <varname>COMPAT22=YES</varname>.  Old compatability
+            libraries change rarely, if ever, so this is not generally
+            needed.</para>
+
+          <para>Also see the ERRATAs for 3.1-RELEASE and
+            3.2-RELEASE.</para>
         </answer>
       </qandaentry>