[src/netbsd-2-0]: src/share/man/man4 Pullup rev 1.236 (requested by mrg in ti...

[jmc <jmc%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/1d9625def023
branches:  netbsd-2-0
changeset: 560429:1d9625def023
user:      jmc <jmc%NetBSD.org@localhost>
date:      Sun Apr 18 02:11:12 2004 +0000

description:
Pullup rev 1.236 (requested by mrg in ticket #144)

Add a useful description for COMPAT_AOUT.

diffstat:

 share/man/man4/options.4 |  36 ++++++++++++++++++++++++------------
 1 files changed, 24 insertions(+), 12 deletions(-)

diffs (57 lines):

diff -r bfd3f7c68cf6 -r 1d9625def023 share/man/man4/options.4
--- a/share/man/man4/options.4  Sun Apr 18 02:10:22 2004 +0000
+++ b/share/man/man4/options.4  Sun Apr 18 02:11:12 2004 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: options.4,v 1.232.2.3 2004/04/18 02:10:05 jmc Exp $
+.\"    $NetBSD: options.4,v 1.232.2.4 2004/04/18 02:11:12 jmc Exp $
 .\"
 .\" Copyright (c) 1996
 .\"    Perry E. Metzger.  All rights reserved.
@@ -30,7 +30,7 @@
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
 .\"
-.Dd April 2, 2004
+.Dd April 3, 2004
 .Os
 .Dt OPTIONS 4
 .Sh NAME
@@ -341,16 +341,28 @@
 .Bx 4.4
 socket calls.
 .It Cd options COMPAT_AOUT
-This option enables support for a.out format executables.  See
-.Em man a.out(5)
-for details on the ancient format.  Note that include
-.Em COMPAT_AOUT
-is
-.Em NOT
-required to run a.out binaries and that doing so may have extremely
-undesirable effects.  it is a deprecated interface that actually is
-harmful to system binaries.  If you use this option you should know
-what you are doing.
+This option is deprecated.
+It was used in the
+.Xr a.out 5
+to
+.Xr elf 5
+transition phase to enable
+.Xr a.out 5
+binaries to find their shared libraries.
+This has been fixed in
+.Xr ld.so 1
+in the meantime.
+The effect is that for
+.Xr a.out 5
+binaries, each name lookup will first search in
+.Pa /emul/aout .
+This causes problems with programs like
+.Xr a.out 5
+shells and emulations that use
+.Xr a.out 5
+(like
+.Tn BSD/OS ) .
+If you use this option you should know what you are doing.
 .It Cd options COMPAT_SVR4
 On those architectures that support it, this enables binary
 compatibility with