[src/trunk]: src/share/man/man4 note that COMPAT_XX netbsd options enable all...

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

details:   https://anonhg.NetBSD.org/src/rev/a517c67f6301
branches:  trunk
changeset: 826559:a517c67f6301
user:      mrg <mrg%NetBSD.org@localhost>
date:      Wed Sep 13 00:34:48 2017 +0000

description:
note that COMPAT_XX netbsd options enable all forward support as well.
eg, COMPAT_60 enables COMPAT_70 and higher.
document the changes in compat for 4, 5, 6, and 7.
bump date.

diffstat:

 share/man/man4/options.4 |  44 ++++++++++++++++++++++++++++++++++++++++++--
 1 files changed, 42 insertions(+), 2 deletions(-)

diffs (85 lines):

diff -r 93eeaf27cdaa -r a517c67f6301 share/man/man4/options.4
--- a/share/man/man4/options.4  Tue Sep 12 14:52:02 2017 +0000
+++ b/share/man/man4/options.4  Wed Sep 13 00:34:48 2017 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: options.4,v 1.470 2017/08/12 08:03:57 maxv Exp $
+.\"    $NetBSD: options.4,v 1.471 2017/09/13 00:34:48 mrg 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 August 12, 2017
+.Dd September 12, 2017
 .Dt OPTIONS 4
 .Os
 .Sh NAME
@@ -173,6 +173,19 @@
 instances.
 .El
 .Ss Compatibility Options
+Note that compatibility options for older
+.Nx
+releases includes on the support for newer releases as well.
+This means that typically only one of these is necessary, with the
+.Cd COMPAT_09
+option enabling all
+.Nx
+compatibility.
+This does not include the
+.Cd COMPAT_43
+or
+.Cd COMPAT_44
+options.
 .Bl -ohang
 .It Cd options COMPAT_09
 Enable binary compatibility with
@@ -323,6 +336,13 @@
 .It Cd options COMPAT_40
 Enable binary compatibility with
 .Nx 4.0 .
+This allows the use of old
+.Xr ptrace 2
+calls for the SH3 platform.
+It also enables old
+.Xr mount 2
+system call that did not include the data length parameter.
+The power_event_t structure's pev_switch is filled in.
 .It Cd options COMPAT_43
 Enables compatibility with
 .Bx 4.3 .
@@ -354,12 +374,32 @@
 .It Cd options COMPAT_50
 Enable binary compatibility with
 .Nx 5.0 .
+This enables support for the old
+.Ft time_t
+and
+.Ft dev_t
+types as 32 bit, and all the associated kernel interface changes.
+It also enables old
+.Xr gpio 4
+and 
+.Xr rnd 4
+interfaces.
 .It Cd options COMPAT_60
 Enable binary compatibility with
 .Nx 6.0 .
+This provides old
+.Xr ccd 4
+interfaces, enables support for old
+.Xr cpuctl 8
+microcode interfaces, and support for the old
+.Ft ptmget
+structure.
 .It Cd options COMPAT_70
 Enable binary compatibility with
 .Nx 7.0 .
+This provides support for old
+.Xr route 4
+interfaces.
 .It Cd options COMPAT_BSDPTY
 This option is currently on by default and enables the pty multiplexer
 .Xr ptm 4