From 59a21c7fb846c483460979be74c546edab0d185e Mon Sep 17 00:00:00 2001
From: Guillem Jover <guillem@hadrons.org>
Date: Mon, 20 Feb 2023 00:11:10 +0100
Origin: upstream, commit:59a21c7fb846c483460979be74c546edab0d185e
Subject: [PATCH] man: Update STANDARDS and HISTORY sections
Include BSD versions when functions were introduced. Add mention
whether these are BSD extensions.
---
man/arc4random.3bsd | 6 ++++++
man/closefrom.3bsd | 13 +++++++++++--
man/fparseln.3bsd | 4 +++-
man/getpeereid.3bsd | 5 ++++-
man/humanize_number.3bsd | 4 +++-
man/pidfile.3bsd | 14 ++++++++++++++
man/pwcache.3bsd | 6 +++---
man/readpassphrase.3bsd | 6 ++++--
man/reallocarray.3bsd | 10 ++++++++--
man/setproctitle.3bsd | 2 ++
man/strlcpy.3bsd | 2 ++
man/strnstr.3bsd | 5 +++++
man/strtonum.3bsd | 4 ++--
man/tree.3bsd | 3 +++
man/wcslcpy.3bsd | 11 +++++++++++
15 files changed, 81 insertions(+), 14 deletions(-)
diff --git a/man/arc4random.3bsd b/man/arc4random.3bsd
index 547bd54..f1dc254 100644
--- a/man/arc4random.3bsd
+++ b/man/arc4random.3bsd
@@ -135,6 +135,12 @@ These functions first appeared in
.Nx 1.6 ,
and
.Dx 1.0 .
+The functions
+.Fn arc4random ,
+.Fn arc4random_buf
+and
+.Fn arc4random_uniform
+appeared in glibc 2.36.
.Pp
The original version of this random number generator used the
RC4 (also known as ARC4) algorithm.
diff --git a/man/closefrom.3bsd b/man/closefrom.3bsd
index 9e1b0db..5f930f5 100644
--- a/man/closefrom.3bsd
+++ b/man/closefrom.3bsd
@@ -51,8 +51,17 @@ from the per-process object reference table.
Any errors encountered while closing file descriptors are ignored.
.Sh SEE ALSO
.Xr close 2
+.Sh STANDARDS
+.Fn closefrom
+is a
+.Bx
+and Solaris extension.
.Sh HISTORY
The
.Fn closefrom
-function first appeared in
-.Fx 8.0 .
+function first appeared in Solaris 9,
+.Ox 3.5 ,
+.Dx 1.2 ,
+.Nx 3.0 ,
+.Fx 8.0
+and glibc 2.34.
diff --git a/man/fparseln.3bsd b/man/fparseln.3bsd
index ab8ad7b..b227f0d 100644
--- a/man/fparseln.3bsd
+++ b/man/fparseln.3bsd
@@ -150,4 +150,6 @@ if it runs out of memory.
The
.Fn fparseln
function first appeared in
-.Nx 1.4 .
+.Nx 1.4
+and
+.Fx 4.0 .
diff --git a/man/getpeereid.3bsd b/man/getpeereid.3bsd
index eafa4b4..4cc7cc6 100644
--- a/man/getpeereid.3bsd
+++ b/man/getpeereid.3bsd
@@ -139,4 +139,7 @@ or the kernel returned invalid data.
The
.Fn getpeereid
function appeared in
-.Fx 4.6 .
+.Fx 4.6 ,
+.Nx 5.0
+and
+.Ox 3.0 .
diff --git a/man/humanize_number.3bsd b/man/humanize_number.3bsd
index 45b1d68..02ce9af 100644
--- a/man/humanize_number.3bsd
+++ b/man/humanize_number.3bsd
@@ -166,7 +166,9 @@ represented a number that does not fit in
.Sh HISTORY
.Fn humanize_number
first appeared in
-.Nx 2.0 .
+.Nx 2.0
+and
+.Fx 5.3 .
.Pp
.Fn dehumanize_number
first appeared in
diff --git a/man/pidfile.3bsd b/man/pidfile.3bsd
index 634ac81..547c556 100644
--- a/man/pidfile.3bsd
+++ b/man/pidfile.3bsd
@@ -292,6 +292,20 @@ Probably called not from the process which used
.Xr open 2 ,
.Xr daemon 3 ,
.Xr flopen 3bsd
+.Sh HISTORY
+The functions
+.Fn pidfile_open ,
+.Fn pidfile_write ,
+.Fn pidfile_close
+and
+.Fn pidfile_remove
+first appeared in
+.Fx 5.5 .
+.Pp
+The function
+.Fn pidfile_fileno
+first appeared in
+.Fx 10.0 .
.Sh AUTHORS
.An -nosplit
The
diff --git a/man/pwcache.3bsd b/man/pwcache.3bsd
index 366c0b2..06c54e1 100644
--- a/man/pwcache.3bsd
+++ b/man/pwcache.3bsd
@@ -137,7 +137,7 @@ The
.Fn uid_from_user
and
.Fn gid_from_group
-functions were ported from
-.Nx
-and first appeared in
+functions first appeared in
+.Nx 1.4
+and
.Ox 6.4 .
diff --git a/man/readpassphrase.3bsd b/man/readpassphrase.3bsd
index 23e5e4c..3c9275d 100644
--- a/man/readpassphrase.3bsd
+++ b/man/readpassphrase.3bsd
@@ -165,10 +165,12 @@ will reprint the prompt and the user may then enter a passphrase.
The
.Fn readpassphrase
function is an
-.Ox
+.Bx
extension and should not be used if portability is desired.
.Sh HISTORY
The
.Fn readpassphrase
function first appeared in
-.Ox 2.9 .
+.Ox 2.9
+and
+.Fx 4.6 .
diff --git a/man/reallocarray.3bsd b/man/reallocarray.3bsd
index f4dbf2b..a63de81 100644
--- a/man/reallocarray.3bsd
+++ b/man/reallocarray.3bsd
@@ -283,12 +283,18 @@ The
.Fn reallocarray
function appeared in
.Ox 5.6 ,
+.Dx 5.5
and glibc 2.26.
+.Pp
The
.Fn recallocarray
function appeared in
-.Ox 6.1 .
+.Ox 6.1
+and
+.Dx 5.5 .
The
.Fn freezero
function appeared in
-.Ox 6.2 .
+.Ox 6.2
+and
+.Dx 5.5 .
diff --git a/man/setproctitle.3bsd b/man/setproctitle.3bsd
index 4a6609f..c8aeb4b 100644
--- a/man/setproctitle.3bsd
+++ b/man/setproctitle.3bsd
@@ -112,6 +112,8 @@ The
.Fn setproctitle
function
first appeared in
+.Nx 1.0
+and
.Fx 2.2 .
Other operating systems have
similar functions.
diff --git a/man/strlcpy.3bsd b/man/strlcpy.3bsd
index 19aaa75..ebc9758 100644
--- a/man/strlcpy.3bsd
+++ b/man/strlcpy.3bsd
@@ -192,4 +192,6 @@ and
functions first appeared in
.Ox 2.4 ,
and made their appearance in
+.Nx 1.4.3
+and
.Fx 3.3 .
diff --git a/man/strnstr.3bsd b/man/strnstr.3bsd
index 44756e6..95e729e 100644
--- a/man/strnstr.3bsd
+++ b/man/strnstr.3bsd
@@ -112,3 +112,8 @@ ptr = strnstr(largestring, smallstring, 4);
.Xr strspn 3 ,
.Xr strtok 3 ,
.Xr wcsstr 3
+.Sh HISTORY
+The
+.Fn strnstr
+function originated in
+.Fx .
diff --git a/man/strtonum.3bsd b/man/strtonum.3bsd
index 44107b1..1041782 100644
--- a/man/strtonum.3bsd
+++ b/man/strtonum.3bsd
@@ -141,8 +141,8 @@ The string did not consist solely of digit characters.
.Xr strtoull 3
.Sh STANDARDS
.Fn strtonum
-is an
-.Ox
+is a
+.Bx
extension.
.Sh HISTORY
.ds doc-operating-system-NetBSD-8.0 8.0
diff --git a/man/tree.3bsd b/man/tree.3bsd
index 2bd4f17..4c9dfb6 100644
--- a/man/tree.3bsd
+++ b/man/tree.3bsd
@@ -562,6 +562,9 @@ main(void)
.Ed
.Sh SEE ALSO
.Xr queue 3bsd
+.Sh HISTORY
+The tree macros first appeared in
+.Fx 4.6 .
.Sh NOTES
Trying to free a tree in the following way is a common error:
.Bd -literal -offset indent
diff --git a/man/wcslcpy.3bsd b/man/wcslcpy.3bsd
index f7ed5a2..3a6169c 100644
--- a/man/wcslcpy.3bsd
+++ b/man/wcslcpy.3bsd
@@ -69,3 +69,14 @@ counterpart, such as
and
.Fn wcslcpy ,
which are BSD extensions.
+.Sh HISTORY
+The
+.Fn wcslcpy
+and
+.Fn wcslcat
+functions first appeared in
+.Ox 3.8 ,
+.Nx 1.6 ,
+.Fx 5.0
+and
+.Dx 2.1 .
--
2.39.2
|
