Commemorate research!dmr by documenting the history of all

system calls existing since Version 1 AT&T UNIX (first batch).
All information taken from primary sources at the UNIX tree of the
UNIX heritage society, http://minnie.tuhs.org/cgi-bin/utree.pl .
The number of errors in the existing manuals is astonishing.
All facts checked by sobrado@.
Feedback and ok on wording and formatting by jmc@.

7 files changed, 53 insertions, 40 deletions

diff --git a/lib/libc/sys/chdir.2 b/lib/libc/sys/chdir.2
index ea24262a7fb..c745fbc0e7d 100644
--- a/lib/libc/sys/chdir.2
+++ b/lib/libc/sys/chdir.2
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: chdir.2,v 1.9 2011/10/24 19:31:56 schwarze Exp $
+.\"	$OpenBSD: chdir.2,v 1.10 2011/11/06 17:22:20 schwarze Exp $
 .\"	$NetBSD: chdir.2,v 1.7 1995/02/27 12:32:00 cgd Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
@@ -30,7 +30,7 @@
 .\"
 .\"     @(#)chdir.2	8.2 (Berkeley) 12/11/93
 .\"
-.Dd $Mdocdate: October 24 2011 $
+.Dd $Mdocdate: November 6 2011 $
 .Dt CHDIR 2
 .Os
 .Sh NAME
@@ -121,6 +121,10 @@ functions are expected to conform to
 .St -p1003.1-2008 .
 .Sh HISTORY
 The
+.Fn chdir
+system call first appeared in
+.At v1 ,
+and
 .Fn fchdir
-function call appeared in
-.Bx 4.2 .
+in
+.Bx 4.3 Reno .
diff --git a/lib/libc/sys/close.2 b/lib/libc/sys/close.2
index 3d334ee1fed..50feeb1fa08 100644
--- a/lib/libc/sys/close.2
+++ b/lib/libc/sys/close.2
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: close.2,v 1.14 2007/05/31 19:19:32 jmc Exp $
+.\"	$OpenBSD: close.2,v 1.15 2011/11/06 17:22:20 schwarze Exp $
 .\"	$NetBSD: close.2,v 1.5 1995/02/27 12:32:14 cgd Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993, 1994
@@ -30,7 +30,7 @@
 .\"
 .\"     @(#)close.2	8.2 (Berkeley) 4/19/94
 .\"
-.Dd $Mdocdate: May 31 2007 $
+.Dd $Mdocdate: November 6 2011 $
 .Dt CLOSE 2
 .Os
 .Sh NAME
@@ -131,3 +131,8 @@ An interrupt was received.
 .Fn close
 conforms to
 .St -p1003.1-88 .
+.Sh HISTORY
+The
+.Fn close
+system call first appeared in
+.At v1 .
diff --git a/lib/libc/sys/fork.2 b/lib/libc/sys/fork.2
index 5acf90c0665..13d9638f82c 100644
--- a/lib/libc/sys/fork.2
+++ b/lib/libc/sys/fork.2
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: fork.2,v 1.14 2007/05/31 19:19:32 jmc Exp $
+.\"	$OpenBSD: fork.2,v 1.15 2011/11/06 17:22:20 schwarze Exp $
 .\"	$NetBSD: fork.2,v 1.6 1995/02/27 12:32:36 cgd Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
@@ -30,7 +30,7 @@
 .\"
 .\"	@(#)fork.2	8.1 (Berkeley) 6/4/93
 .\"
-.Dd $Mdocdate: May 31 2007 $
+.Dd $Mdocdate: November 6 2011 $
 .Dt FORK 2
 .Os
 .Sh NAME
@@ -122,7 +122,7 @@ The
 function conforms to
 .St -p1003.1-90 .
 .Sh HISTORY
-A
+The
 .Fn fork
-function call appeared in
-.At v2 .
+system call first appeared in
+.At v1 .
diff --git a/lib/libc/sys/lseek.2 b/lib/libc/sys/lseek.2
index 4b9247f0b11..5c91ce3f86d 100644
--- a/lib/libc/sys/lseek.2
+++ b/lib/libc/sys/lseek.2
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: lseek.2,v 1.14 2007/05/31 19:19:32 jmc Exp $
+.\"	$OpenBSD: lseek.2,v 1.15 2011/11/06 17:22:20 schwarze Exp $
 .\"	$NetBSD: lseek.2,v 1.6 1995/02/27 12:34:09 cgd Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
@@ -30,7 +30,7 @@
 .\"
 .\"     @(#)lseek.2	8.3 (Berkeley) 4/19/94
 .\"
-.Dd $Mdocdate: May 31 2007 $
+.Dd $Mdocdate: November 6 2011 $
 .Dt LSEEK 2
 .Os
 .Sh NAME
@@ -127,9 +127,11 @@ function conforms to
 .Sh HISTORY
 A
 .Fn seek
-function appeared in
-.At v2 ,
-later renamed into
+system call first appeared in
+.At v1 .
+In
+.At v7
+it was renamed to
 .Fn lseek
 for
 .Dq long seek
diff --git a/lib/libc/sys/open.2 b/lib/libc/sys/open.2
index 45b4ee28d8f..36e073705a5 100644
--- a/lib/libc/sys/open.2
+++ b/lib/libc/sys/open.2
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: open.2,v 1.39 2011/07/18 23:04:40 matthew Exp $
+.\"	$OpenBSD: open.2,v 1.40 2011/11/06 17:22:20 schwarze Exp $
 .\"	$NetBSD: open.2,v 1.8 1995/02/27 12:35:14 cgd Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
@@ -30,7 +30,7 @@
 .\"
 .\"     @(#)open.2	8.2 (Berkeley) 11/16/93
 .\"
-.Dd $Mdocdate: July 18 2011 $
+.Dd $Mdocdate: November 6 2011 $
 .Dt OPEN 2
 .Os
 .Sh NAME
@@ -408,8 +408,12 @@ is of concern.
 .Sh HISTORY
 An
 .Fn open
-function call appeared in
-.At v2 .
+system call first appeared in
+.At v1 .
+The
+.Fa flags
+arguments has been supported since
+.Bx 4.2 .
 The
 .Fn openat
 function call appeared in
diff --git a/lib/libc/sys/read.2 b/lib/libc/sys/read.2
index 47bb157df19..3f9c585531d 100644
--- a/lib/libc/sys/read.2
+++ b/lib/libc/sys/read.2
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: read.2,v 1.30 2011/11/06 12:07:22 deraadt Exp $
+.\"	$OpenBSD: read.2,v 1.31 2011/11/06 17:22:20 schwarze Exp $
 .\"	$NetBSD: read.2,v 1.6 1995/02/27 12:35:47 cgd Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
@@ -242,22 +242,20 @@ and
 functions conform to
 .St -xpg4.2 .
 .Sh HISTORY
-The
+A
+.Fn read
+system call first appeared in
+.At v1 ;
+.Fn readv
+in
+.Bx 4.2 ;
+.Fn pread
+in
+.At V.4 ;
+and
 .Fn preadv
-function first appeared in
+in
 .Ox 2.7 .
-The
-.Fn pread
-function appeared in
-.At V.4 .
-The
-.Fn readv
-function call appeared in
-.Bx 4.2 .
-The
-.Fn read
-function call appeared in
-.At v2 .
 .Sh CAVEATS
 Error checks should explicitly test for \-1.
 Code such as
diff --git a/lib/libc/sys/unlink.2 b/lib/libc/sys/unlink.2
index 0f4e5cb0ce2..ba66358a51a 100644
--- a/lib/libc/sys/unlink.2
+++ b/lib/libc/sys/unlink.2
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: unlink.2,v 1.19 2011/07/26 20:49:40 matthew Exp $
+.\"	$OpenBSD: unlink.2,v 1.20 2011/11/06 17:22:20 schwarze Exp $
 .\"	$NetBSD: unlink.2,v 1.7 1995/02/27 12:39:13 cgd Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
@@ -30,7 +30,7 @@
 .\"
 .\"     @(#)unlink.2	8.1 (Berkeley) 6/4/93
 .\"
-.Dd $Mdocdate: July 26 2011 $
+.Dd $Mdocdate: November 6 2011 $
 .Dt UNLINK 2
 .Os
 .Sh NAME
@@ -202,10 +202,10 @@ and
 functions conform to
 .St -p1003.1-2008 .
 .Sh HISTORY
-An
+The
 .Fn unlink
-function call appeared in
-.At v2 .
+system call first appeared in
+.At v1 .
 The
 .Fn unlinkat
 function appeared in