[src/trunk]: src/lib Sections 2 and 3 have RETURN VALUES, not DIAGNOSTICS

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

details:   https://anonhg.NetBSD.org/src/rev/fe44bf9174d6
branches:  trunk
changeset: 372509:fe44bf9174d6
user:      uwe <uwe%NetBSD.org@localhost>
date:      Sun Dec 04 01:29:31 2022 +0000

description:
Sections 2 and 3 have RETURN VALUES, not DIAGNOSTICS

diffstat:

 lib/libbluetooth/bluetooth.3       |  4 ++--
 lib/libc/gen/cgetcap.3             |  4 ++--
 lib/libc/gen/getusershell.3        |  4 ++--
 lib/libc/gen/scandir.3             |  4 ++--
 lib/libc/gen/wordexp.3             |  4 ++--
 lib/libc/inet/inet.3               |  4 ++--
 lib/libc/inet/inet6_option_space.3 |  4 ++--
 lib/libc/inet/inet6_rthdr_space.3  |  4 ++--
 lib/libc/net/gethostbyname.3       |  4 ++--
 lib/libc/net/getnetent.3           |  4 ++--
 lib/libc/net/inet6_opt_init.3      |  4 ++--
 lib/libc/net/inet6_option_space.3  |  4 ++--
 lib/libc/net/inet6_rth_space.3     |  4 ++--
 lib/libc/net/inet6_rthdr_space.3   |  4 ++--
 lib/libc/net/rcmd.3                |  4 ++--
 lib/libc/regex/regex.3             |  4 ++--
 lib/libc/rpc/getrpcent.3           |  4 ++--
 lib/libc/stdlib/getopt.3           |  4 ++--
 lib/libc/stdlib/jemalloc.3         |  4 ++--
 lib/libc/stdlib/random.3           |  4 ++--
 lib/libc/sys/intro.2               |  4 ++--
 lib/libcompat/4.1/stty.3           |  9 +++------
 lib/libcompat/4.3/re_comp.3        |  4 ++--
 lib/librmt/rmtops.3                |  4 ++--
 lib/librt/aio_read.3               |  4 +---
 lib/libutil/getmntopts.3           |  4 ++--
 26 files changed, 52 insertions(+), 57 deletions(-)

diffs (truncated from 480 to 300 lines):

diff -r 23a1e9daa098 -r fe44bf9174d6 lib/libbluetooth/bluetooth.3
--- a/lib/libbluetooth/bluetooth.3      Sun Dec 04 00:13:11 2022 +0000
+++ b/lib/libbluetooth/bluetooth.3      Sun Dec 04 01:29:31 2022 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: bluetooth.3,v 1.9 2017/07/03 21:32:49 wiz Exp $
+.\" $NetBSD: bluetooth.3,v 1.10 2022/12/04 01:29:31 uwe Exp $
 .\"
 .\" Copyright (c) 2003 Maksim Yevmenkin <m_evmenkin%yahoo.com@localhost>
 .\" All rights reserved.
@@ -208,7 +208,7 @@
 
 printf("name associated with %s is %s\en", bdstr, hp->h_name);
 .Ed
-.Sh DIAGNOSTICS
+.Sh RETURN VALUES
 Error return status from
 .Fn bt_gethostent ,
 .Fn bt_gethostbyname ,
diff -r 23a1e9daa098 -r fe44bf9174d6 lib/libc/gen/cgetcap.3
--- a/lib/libc/gen/cgetcap.3    Sun Dec 04 00:13:11 2022 +0000
+++ b/lib/libc/gen/cgetcap.3    Sun Dec 04 01:29:31 2022 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: cgetcap.3,v 1.9 2017/10/24 18:42:06 abhinav Exp $
+.\"    $NetBSD: cgetcap.3,v 1.10 2022/12/04 01:29:32 uwe Exp $
 .\"
 .\" Copyright (c) 1992, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -315,7 +315,7 @@
 can be used to control if
 .Qq tc
 expansion is performed or not.
-.Sh DIAGNOSTICS
+.Sh RETURN VALUES
 .Fn cgetent ,
 .Fn cgetset ,
 .Fn cgetmatch ,
diff -r 23a1e9daa098 -r fe44bf9174d6 lib/libc/gen/getusershell.3
--- a/lib/libc/gen/getusershell.3       Sun Dec 04 00:13:11 2022 +0000
+++ b/lib/libc/gen/getusershell.3       Sun Dec 04 01:29:31 2022 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: getusershell.3,v 1.10 2004/11/23 04:38:19 lukem Exp $
+.\"    $NetBSD: getusershell.3,v 1.11 2022/12/04 01:29:32 uwe Exp $
 .\"
 .\" Copyright (c) 1985, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -75,7 +75,7 @@
 .Bl -tag -width /etc/shells -compact
 .It Pa /etc/shells
 .El
-.Sh DIAGNOSTICS
+.Sh RETURN VALUES
 The routine
 .Fn getusershell
 returns a null pointer (0) on
diff -r 23a1e9daa098 -r fe44bf9174d6 lib/libc/gen/scandir.3
--- a/lib/libc/gen/scandir.3    Sun Dec 04 00:13:11 2022 +0000
+++ b/lib/libc/gen/scandir.3    Sun Dec 04 01:29:31 2022 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: scandir.3,v 1.16 2016/12/17 10:25:49 wiz Exp $
+.\"    $NetBSD: scandir.3,v 1.17 2022/12/04 01:29:32 uwe Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -88,7 +88,7 @@
 The memory allocated for the array can be deallocated with
 .Xr free 3 ,
 by freeing each pointer in the array and then the array itself.
-.Sh DIAGNOSTICS
+.Sh RETURN VALUES
 Returns \-1 if the directory cannot be opened for reading or if
 .Xr malloc 3
 cannot allocate enough memory to hold all the data structures.
diff -r 23a1e9daa098 -r fe44bf9174d6 lib/libc/gen/wordexp.3
--- a/lib/libc/gen/wordexp.3    Sun Dec 04 00:13:11 2022 +0000
+++ b/lib/libc/gen/wordexp.3    Sun Dec 04 01:29:31 2022 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: wordexp.3,v 1.4 2021/12/10 20:36:02 andvar Exp $
+.\"    $NetBSD: wordexp.3,v 1.5 2022/12/04 01:29:32 uwe Exp $
 .\"
 .\" Copyright (c) 2002 Tim J. Robbins
 .\" All rights reserved.
@@ -189,7 +189,7 @@
 wordexp("${EDITOR:-vi} *.c /etc/motd", &we, 0);
 execvp(we->we_wordv[0], we->we_wordv);
 .Ed
-.Sh DIAGNOSTICS
+.Sh DIAGNOSTICS                \" sic!
 Diagnostic messages from the shell are written to the standard error output
 if
 .Dv WRDE_SHOWERR
diff -r 23a1e9daa098 -r fe44bf9174d6 lib/libc/inet/inet.3
--- a/lib/libc/inet/inet.3      Sun Dec 04 00:13:11 2022 +0000
+++ b/lib/libc/inet/inet.3      Sun Dec 04 01:29:31 2022 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: inet.3,v 1.5 2012/07/25 14:51:15 ginsbach Exp $
+.\"    $NetBSD: inet.3,v 1.6 2022/12/04 01:29:32 uwe Exp $
 .\"
 .\" Copyright (c) 1983, 1990, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -277,7 +277,7 @@
 ::FFFF:129.144.52.38
 .Ed
 .El
-.Sh DIAGNOSTICS
+.Sh RETURN VALUES
 The constant
 .Dv INADDR_NONE
 is returned by
diff -r 23a1e9daa098 -r fe44bf9174d6 lib/libc/inet/inet6_option_space.3
--- a/lib/libc/inet/inet6_option_space.3        Sun Dec 04 00:13:11 2022 +0000
+++ b/lib/libc/inet/inet6_option_space.3        Sun Dec 04 01:29:31 2022 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: inet6_option_space.3,v 1.3 2010/03/22 19:30:54 joerg Exp $
+.\"    $NetBSD: inet6_option_space.3,v 1.4 2022/12/04 01:29:32 uwe Exp $
 .\"    $KAME: inet6_option_space.3,v 1.7 2000/05/17 14:32:13 itojun Exp $
 .\"
 .\" Copyright (c) 1983, 1987, 1991, 1993
@@ -392,7 +392,7 @@
 .Sh EXAMPLES
 RFC 2292 gives comprehensive examples in chapter 6.
 .\"
-.Sh DIAGNOSTICS
+.Sh RETURN VALUES
 .Fn inet6_option_init
 and
 .Fn inet6_option_append
diff -r 23a1e9daa098 -r fe44bf9174d6 lib/libc/inet/inet6_rthdr_space.3
--- a/lib/libc/inet/inet6_rthdr_space.3 Sun Dec 04 00:13:11 2022 +0000
+++ b/lib/libc/inet/inet6_rthdr_space.3 Sun Dec 04 01:29:31 2022 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: inet6_rthdr_space.3,v 1.3 2017/07/03 21:32:49 wiz Exp $
+.\"    $NetBSD: inet6_rthdr_space.3,v 1.4 2022/12/04 01:29:32 uwe Exp $
 .\"    $KAME: inet6_rthdr_space.3,v 1.8 2000/05/17 14:30:15 itojun Exp $
 .\"
 .\" Copyright (c) 1983, 1987, 1991, 1993
@@ -267,7 +267,7 @@
 .Sh EXAMPLES
 RFC 2292 gives comprehensive examples in chapter 8.
 .\"
-.Sh DIAGNOSTICS
+.Sh RETURN VALUES
 .Fn inet6_rthdr_space
 returns 0 on errors.
 .Pp
diff -r 23a1e9daa098 -r fe44bf9174d6 lib/libc/net/gethostbyname.3
--- a/lib/libc/net/gethostbyname.3      Sun Dec 04 00:13:11 2022 +0000
+++ b/lib/libc/net/gethostbyname.3      Sun Dec 04 01:29:31 2022 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: gethostbyname.3,v 1.29 2013/08/19 07:18:42 christos Exp $
+.\"    $NetBSD: gethostbyname.3,v 1.30 2022/12/04 01:29:32 uwe Exp $
 .\"
 .\" Copyright (c) 1983, 1987, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -216,7 +216,7 @@
 .Bl -tag -width /etc/hosts -compact
 .It Pa /etc/hosts
 .El
-.Sh DIAGNOSTICS
+.Sh RETURN VALUES
 Error return status from
 .Fn gethostbyent ,
 .Fn gethostbyname ,
diff -r 23a1e9daa098 -r fe44bf9174d6 lib/libc/net/getnetent.3
--- a/lib/libc/net/getnetent.3  Sun Dec 04 00:13:11 2022 +0000
+++ b/lib/libc/net/getnetent.3  Sun Dec 04 01:29:31 2022 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: getnetent.3,v 1.16 2018/02/21 14:11:09 uwe Exp $
+.\"    $NetBSD: getnetent.3,v 1.17 2022/12/04 01:29:32 uwe Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -118,7 +118,7 @@
 .Bl -tag -width /etc/networks -compact
 .It Pa /etc/networks
 .El
-.Sh DIAGNOSTICS
+.Sh RETURN VALUES
 Null pointer
 .Dv ( NULL )
 returned on
diff -r 23a1e9daa098 -r fe44bf9174d6 lib/libc/net/inet6_opt_init.3
--- a/lib/libc/net/inet6_opt_init.3     Sun Dec 04 00:13:11 2022 +0000
+++ b/lib/libc/net/inet6_opt_init.3     Sun Dec 04 01:29:31 2022 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: inet6_opt_init.3,v 1.2 2014/01/04 15:37:26 wiz Exp $
+.\"    $NetBSD: inet6_opt_init.3,v 1.3 2022/12/04 01:29:32 uwe Exp $
 .\"    $KAME: inet6_opt_init.3,v 1.7 2004/12/27 05:08:23 itojun Exp $
 .\"
 .\" Copyright (C) 2004 WIDE Project.
@@ -306,7 +306,7 @@
 .Pa advapitest
 directory of its kit.
 .\"
-.Sh DIAGNOSTICS
+.Sh RETURN VALUES
 All the functions return
 \-1
 on an error.
diff -r 23a1e9daa098 -r fe44bf9174d6 lib/libc/net/inet6_option_space.3
--- a/lib/libc/net/inet6_option_space.3 Sun Dec 04 00:13:11 2022 +0000
+++ b/lib/libc/net/inet6_option_space.3 Sun Dec 04 01:29:31 2022 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: inet6_option_space.3,v 1.17 2010/03/22 19:30:54 joerg Exp $
+.\"    $NetBSD: inet6_option_space.3,v 1.18 2022/12/04 01:29:32 uwe Exp $
 .\"    $KAME: inet6_option_space.3,v 1.7 2000/05/17 14:32:13 itojun Exp $
 .\"
 .\" Copyright (c) 1983, 1987, 1991, 1993
@@ -392,7 +392,7 @@
 .Sh EXAMPLES
 RFC 2292 gives comprehensive examples in chapter 6.
 .\"
-.Sh DIAGNOSTICS
+.Sh RETURN VALUES
 .Fn inet6_option_init
 and
 .Fn inet6_option_append
diff -r 23a1e9daa098 -r fe44bf9174d6 lib/libc/net/inet6_rth_space.3
--- a/lib/libc/net/inet6_rth_space.3    Sun Dec 04 00:13:11 2022 +0000
+++ b/lib/libc/net/inet6_rth_space.3    Sun Dec 04 01:29:31 2022 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: inet6_rth_space.3,v 1.2 2014/01/04 15:37:46 wiz Exp $
+.\"    $NetBSD: inet6_rth_space.3,v 1.3 2022/12/04 01:29:32 uwe Exp $
 .\"    $KAME: inet6_rth_space.3,v 1.7 2005/01/05 03:00:44 itojun Exp $
 .\"
 .\" Copyright (C) 2004 WIDE Project.
@@ -184,7 +184,7 @@
 .Pp
 KAME also provides examples in the advapitest directory of its kit.
 .\"
-.Sh DIAGNOSTICS
+.Sh RETURN VALUES
 The
 .Fn inet6_rth_space
 and
diff -r 23a1e9daa098 -r fe44bf9174d6 lib/libc/net/inet6_rthdr_space.3
--- a/lib/libc/net/inet6_rthdr_space.3  Sun Dec 04 00:13:11 2022 +0000
+++ b/lib/libc/net/inet6_rthdr_space.3  Sun Dec 04 01:29:31 2022 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: inet6_rthdr_space.3,v 1.17 2017/07/03 21:32:49 wiz Exp $
+.\"    $NetBSD: inet6_rthdr_space.3,v 1.18 2022/12/04 01:29:32 uwe Exp $
 .\"    $KAME: inet6_rthdr_space.3,v 1.8 2000/05/17 14:30:15 itojun Exp $
 .\"
 .\" Copyright (c) 1983, 1987, 1991, 1993
@@ -267,7 +267,7 @@
 .Sh EXAMPLES
 RFC 2292 gives comprehensive examples in chapter 8.
 .\"
-.Sh DIAGNOSTICS
+.Sh RETURN VALUES
 .Fn inet6_rthdr_space
 returns 0 on errors.
 .Pp
diff -r 23a1e9daa098 -r fe44bf9174d6 lib/libc/net/rcmd.3
--- a/lib/libc/net/rcmd.3       Sun Dec 04 00:13:11 2022 +0000
+++ b/lib/libc/net/rcmd.3       Sun Dec 04 01:29:31 2022 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: rcmd.3,v 1.28 2010/03/22 19:30:54 joerg Exp $
+.\"    $NetBSD: rcmd.3,v 1.29 2022/12/04 01:29:32 uwe Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -258,7 +258,7 @@
 function, this variable is used as the program to run instead of
 .Xr rcmd 1 .
 .El
-.Sh DIAGNOSTICS
+.Sh RETURN VALUES
 The
 .Fn rcmd
 function
diff -r 23a1e9daa098 -r fe44bf9174d6 lib/libc/regex/regex.3
--- a/lib/libc/regex/regex.3    Sun Dec 04 00:13:11 2022 +0000
+++ b/lib/libc/regex/regex.3    Sun Dec 04 01:29:31 2022 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: regex.3,v 1.32 2021/03/11 18:49:18 christos Exp $
+.\" $NetBSD: regex.3,v 1.33 2022/12/04 01:29:32 uwe Exp $
 .\"
 .\" Copyright (c) 1992, 1993, 1994 Henry Spencer.
 .\" Copyright (c) 1992, 1993, 1994
@@ -711,7 +711,7 @@
 beginning and ending subexpressions in obsolete
 .Pq Dq basic
 REs are anchors, not ordinary characters.
-.Sh DIAGNOSTICS
+.Sh RETURN VALUES
 Non-zero error codes from
 .Fn regcomp
 and
diff -r 23a1e9daa098 -r fe44bf9174d6 lib/libc/rpc/getrpcent.3
--- a/lib/libc/rpc/getrpcent.3  Sun Dec 04 00:13:11 2022 +0000
+++ b/lib/libc/rpc/getrpcent.3  Sun Dec 04 01:29:31 2022 +0000
@@ -1,5 +1,5 @@
 .\"    @(#)getrpcent.3n        2.2 88/08/02 4.0 RPCSRC; from 1.11 88/03/14 SMI
-.\"    $NetBSD: getrpcent.3,v 1.14 2004/08/16 10:18:27 wiz Exp $
+.\"    $NetBSD: getrpcent.3,v 1.15 2022/12/04 01:29:32 uwe Exp $
 .\"
 .Dd August 16, 2004
 .Dt GETRPCENT 3
@@ -79,7 +79,7 @@
 program number is found, or until end-of-file is encountered.