From 59a21c7fb846c483460979be74c546edab0d185e Mon Sep 17 00:00:00 2001 From: Guillem Jover 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