Source-Changes-HG archive
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]
[src/trunk]: src/lib/libutil lib: Mark up error names in man pages with .Er
details: https://anonhg.NetBSD.org/src/rev/d7da74e3622c
branches: trunk
changeset: 372515:d7da74e3622c
user: uwe <uwe%NetBSD.org@localhost>
date: Sun Dec 04 11:25:08 2022 +0000
description:
lib: Mark up error names in man pages with .Er
diffstat:
lib/libc/compat-43/sigpause.3 | 4 ++--
lib/libc/compat-43/sigvec.3 | 4 ++--
lib/libc/gen/glob.3 | 6 +++---
lib/libc/gen/popen.3 | 4 ++--
lib/libc/gen/siginterrupt.3 | 4 ++--
lib/libc/gen/sysctl.3 | 5 +++--
lib/libc/gen/vis.3 | 4 ++--
lib/libc/net/rcmd.3 | 4 ++--
lib/libc/stdlib/reallocarray.3 | 4 ++--
lib/libc/stdlib/strtod.3 | 6 +++---
lib/libc/sys/_lwp_create.2 | 5 +++--
lib/libc/sys/fcntl.2 | 4 ++--
lib/libc/sys/wait.2 | 4 ++--
lib/libc/time/tzset.3 | 4 ++--
lib/libm/man/acos.3 | 5 +++--
lib/libm/man/acosh.3 | 5 +++--
lib/libm/man/atanh.3 | 5 +++--
lib/libm/man/cosh.3 | 5 +++--
lib/libm/man/sqrt.3 | 5 +++--
lib/libossaudio/ossaudio.3 | 6 +++---
lib/librmt/rmtops.3 | 6 ++++--
lib/libutil/sockaddr_snprintf.3 | 4 ++--
22 files changed, 56 insertions(+), 47 deletions(-)
diffs (truncated from 440 to 300 lines):
diff -r 1e1a77716e26 -r d7da74e3622c lib/libc/compat-43/sigpause.3
--- a/lib/libc/compat-43/sigpause.3 Sun Dec 04 11:18:58 2022 +0000
+++ b/lib/libc/compat-43/sigpause.3 Sun Dec 04 11:25:08 2022 +0000
@@ -26,7 +26,7 @@
.\" SUCH DAMAGE.
.\"
.\" from: @(#)sigpause.2 8.1 (Berkeley) 6/2/93
-.\" $NetBSD: sigpause.3,v 1.15 2003/08/07 16:42:40 agc Exp $
+.\" $NetBSD: sigpause.3,v 1.16 2022/12/04 11:25:08 uwe Exp $
.\"
.Dd June 2, 1993
.Dt SIGPAUSE 3
@@ -59,7 +59,7 @@
always terminates by being interrupted, returning -1 with
.Va errno
set to
-.Dv EINTR .
+.Er EINTR .
.Sh SEE ALSO
.Xr kill 2 ,
.Xr sigaction 2 ,
diff -r 1e1a77716e26 -r d7da74e3622c lib/libc/compat-43/sigvec.3
--- a/lib/libc/compat-43/sigvec.3 Sun Dec 04 11:18:58 2022 +0000
+++ b/lib/libc/compat-43/sigvec.3 Sun Dec 04 11:25:08 2022 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: sigvec.3,v 1.26 2010/03/22 19:30:53 joerg Exp $
+.\" $NetBSD: sigvec.3,v 1.27 2022/12/04 11:25:08 uwe Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -189,7 +189,7 @@
the call may return with a data transfer shorter than requested,
or the call may be forced to terminate
with the error
-.Dv EINTR .
+.Er EINTR .
Interrupting of pending calls is requested
by setting the
.Dv SV_INTERRUPT
diff -r 1e1a77716e26 -r d7da74e3622c lib/libc/gen/glob.3
--- a/lib/libc/gen/glob.3 Sun Dec 04 11:18:58 2022 +0000
+++ b/lib/libc/gen/glob.3 Sun Dec 04 11:25:08 2022 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: glob.3,v 1.44 2019/05/29 01:21:33 christos Exp $
+.\" $NetBSD: glob.3,v 1.45 2022/12/04 11:25:08 uwe Exp $
.\"
.\" Copyright (c) 1989, 1991, 1993, 1994
.\" The Regents of the University of California. All rights reserved.
@@ -316,9 +316,9 @@
call to
.Fa errfunc .
The error routine can suppress this action by testing for
-.Dv ENOENT
+.Er ENOENT
and
-.Dv ENOTDIR ;
+.Er ENOTDIR ;
however, the
.Dv GLOB_ERR
flag will still cause an immediate
diff -r 1e1a77716e26 -r d7da74e3622c lib/libc/gen/popen.3
--- a/lib/libc/gen/popen.3 Sun Dec 04 11:18:58 2022 +0000
+++ b/lib/libc/gen/popen.3 Sun Dec 04 11:25:08 2022 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: popen.3,v 1.24 2022/03/27 00:32:15 gutteridge Exp $
+.\" $NetBSD: popen.3,v 1.25 2022/12/04 11:25:08 uwe Exp $
.\"
.\" Copyright (c) 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -163,7 +163,7 @@
has already been
.Dq pclosed ,
setting errno to
-.Dv ESRCH ,
+.Er ESRCH ,
or if
.Xr wait4 2
returns an error, preserving the errno returned by
diff -r 1e1a77716e26 -r d7da74e3622c lib/libc/gen/siginterrupt.3
--- a/lib/libc/gen/siginterrupt.3 Sun Dec 04 11:18:58 2022 +0000
+++ b/lib/libc/gen/siginterrupt.3 Sun Dec 04 11:25:08 2022 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: siginterrupt.3,v 1.11 2003/08/07 16:42:56 agc Exp $
+.\" $NetBSD: siginterrupt.3,v 1.12 2022/12/04 11:25:08 uwe Exp $
.\"
.\" Copyright (c) 1985, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -60,7 +60,7 @@
the system call will return \-1 with the global variable
.Va errno
set to
-.Dv EINTR .
+.Er EINTR .
Interrupted system calls that have started transferring
data will return the amount of data actually transferred.
System call interrupt is the signal behavior found on
diff -r 1e1a77716e26 -r d7da74e3622c lib/libc/gen/sysctl.3
--- a/lib/libc/gen/sysctl.3 Sun Dec 04 11:18:58 2022 +0000
+++ b/lib/libc/gen/sysctl.3 Sun Dec 04 11:25:08 2022 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: sysctl.3,v 1.206 2019/09/15 07:01:13 wiz Exp $
+.\" $NetBSD: sysctl.3,v 1.207 2022/12/04 11:25:08 uwe Exp $
.\"
.\" Copyright (c) 1993
.\" The Regents of the University of California. All rights reserved.
@@ -105,7 +105,8 @@
If the amount of data available is greater
than the size of the buffer supplied,
the call supplies as much data as fits in the buffer provided
-and returns with the error code ENOMEM.
+and returns with the error code
+.Er ENOMEM .
If the old value is not desired,
.Fa oldp
and
diff -r 1e1a77716e26 -r d7da74e3622c lib/libc/gen/vis.3
--- a/lib/libc/gen/vis.3 Sun Dec 04 11:18:58 2022 +0000
+++ b/lib/libc/gen/vis.3 Sun Dec 04 11:25:08 2022 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: vis.3,v 1.49 2017/08/05 20:22:29 wiz Exp $
+.\" $NetBSD: vis.3,v 1.50 2022/12/04 11:25:08 uwe Exp $
.\"
.\" Copyright (c) 1989, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -179,7 +179,7 @@
functions return \-1 and set
.Va errno
to
-.Dv ENOSPC .
+.Er ENOSPC .
The
.Fn strenvisx
function takes an additional argument,
diff -r 1e1a77716e26 -r d7da74e3622c lib/libc/net/rcmd.3
--- a/lib/libc/net/rcmd.3 Sun Dec 04 11:18:58 2022 +0000
+++ b/lib/libc/net/rcmd.3 Sun Dec 04 11:25:08 2022 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: rcmd.3,v 1.29 2022/12/04 01:29:32 uwe Exp $
+.\" $NetBSD: rcmd.3,v 1.30 2022/12/04 11:25:08 uwe Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -275,7 +275,7 @@
.Va errno
set according to the reason for failure.
The error code
-.Dv EAGAIN
+.Er EAGAIN
is overloaded to mean ``All network ports in use.''
.Sh SEE ALSO
.Xr rcmd 1 ,
diff -r 1e1a77716e26 -r d7da74e3622c lib/libc/stdlib/reallocarray.3
--- a/lib/libc/stdlib/reallocarray.3 Sun Dec 04 11:18:58 2022 +0000
+++ b/lib/libc/stdlib/reallocarray.3 Sun Dec 04 11:25:08 2022 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: reallocarray.3,v 1.6 2022/11/27 20:17:20 gutteridge Exp $
+.\" $NetBSD: reallocarray.3,v 1.7 2022/12/04 11:25:08 uwe Exp $
.\"
.\" Copyright (c) 2015 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -66,7 +66,7 @@
failed setting
.Va errno
to
-.Dv ENOMEM
+.Er ENOMEM
or preserving the value from
.Xr realloc 3 .
.Sh SEE ALSO
diff -r 1e1a77716e26 -r d7da74e3622c lib/libc/stdlib/strtod.3
--- a/lib/libc/stdlib/strtod.3 Sun Dec 04 11:18:58 2022 +0000
+++ b/lib/libc/stdlib/strtod.3 Sun Dec 04 11:25:08 2022 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: strtod.3,v 1.29 2016/11/07 21:52:36 riastradh Exp $
+.\" $NetBSD: strtod.3,v 1.30 2022/12/04 11:25:08 uwe Exp $
.\"
.\" Copyright (c) 1990, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -159,7 +159,7 @@
or
.Dv HUGE_VALL
is returned (according to the return type and sign of the value), and
-.Dv ERANGE
+.Er ERANGE
is stored in
.Va errno .
.Pp
@@ -167,7 +167,7 @@
normally with full precision
.Pq Sq underflow ,
the closest subnormal value, or zero, is returned, and
-.Dv ERANGE
+.Er ERANGE
is stored in
.Va errno .
.Sh EXAMPLES
diff -r 1e1a77716e26 -r d7da74e3622c lib/libc/sys/_lwp_create.2
--- a/lib/libc/sys/_lwp_create.2 Sun Dec 04 11:18:58 2022 +0000
+++ b/lib/libc/sys/_lwp_create.2 Sun Dec 04 11:25:08 2022 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: _lwp_create.2,v 1.9 2021/08/22 20:18:39 andvar Exp $
+.\" $NetBSD: _lwp_create.2,v 1.10 2022/12/04 11:25:09 uwe Exp $
.\"
.\" Copyright (c) 2003 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -52,7 +52,8 @@
If this context specifies invalid register values (for example privilege
escalation by setting machine dependent bits forbidden for user processes),
or does not specify cpu register values (uc_flags does not have the
-_UC_CPU bit set), the call will fail and errno will be set to EINVAL.
+_UC_CPU bit set), the call will fail and errno will be set to
+.Er EINVAL .
.Pp
The following flags affect the creation of the new LWP:
.Bl -tag -width LWP_SUSPENDED
diff -r 1e1a77716e26 -r d7da74e3622c lib/libc/sys/fcntl.2
--- a/lib/libc/sys/fcntl.2 Sun Dec 04 11:18:58 2022 +0000
+++ b/lib/libc/sys/fcntl.2 Sun Dec 04 11:25:08 2022 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: fcntl.2,v 1.47 2021/07/28 11:29:59 wiz Exp $
+.\" $NetBSD: fcntl.2,v 1.48 2022/12/04 11:25:09 uwe Exp $
.\"
.\" Copyright (c) 1983, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -340,7 +340,7 @@
may fail if the corresponding entry has been evicted from the LRU
.Xr namei 9
cache and return
-.Dv ENOENT .
+.Er ENOENT .
.It
File descriptors that don't point to vnodes are not handled, as
well as symbolic links since there is currently no way to obtain
diff -r 1e1a77716e26 -r d7da74e3622c lib/libc/sys/wait.2
--- a/lib/libc/sys/wait.2 Sun Dec 04 11:18:58 2022 +0000
+++ b/lib/libc/sys/wait.2 Sun Dec 04 11:25:08 2022 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: wait.2,v 1.41 2022/10/17 18:41:06 jschauma Exp $
+.\" $NetBSD: wait.2,v 1.42 2022/12/04 11:25:09 uwe Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993, 1994
.\" The Regents of the University of California. All rights reserved.
@@ -373,7 +373,7 @@
return \-1 with
.Dv errno
set to
-.Dv EINVAL .
+.Er EINVAL .
.Pp
If
.Fa rusage
diff -r 1e1a77716e26 -r d7da74e3622c lib/libc/time/tzset.3
--- a/lib/libc/time/tzset.3 Sun Dec 04 11:18:58 2022 +0000
+++ b/lib/libc/time/tzset.3 Sun Dec 04 11:25:08 2022 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: tzset.3,v 1.43 2022/08/23 14:54:50 christos Exp $
+.\" $NetBSD: tzset.3,v 1.44 2022/12/04 11:25:09 uwe Exp $
.Dd Auguset 23, 2021
.Dt TZSET 3
.Os
@@ -105,7 +105,7 @@
is returned and
.Va errno
is set to
-.Dv ESRCH .
+.Er ESRCH .
The
.Fn tzset
function acts like
diff -r 1e1a77716e26 -r d7da74e3622c lib/libm/man/acos.3
--- a/lib/libm/man/acos.3 Sun Dec 04 11:18:58 2022 +0000
+++ b/lib/libm/man/acos.3 Sun Dec 04 11:25:08 2022 +0000
@@ -26,7 +26,7 @@
.\" SUCH DAMAGE.
.\"
.\" from: @(#)acos.3 5.1 (Berkeley) 5/2/91
-.\" $NetBSD: acos.3,v 1.18 2017/07/03 21:32:50 wiz Exp $
+.\" $NetBSD: acos.3,v 1.19 2022/12/04 11:25:09 uwe Exp $
.\"
.Dd January 29, 2013
.Dt ACOS 3
@@ -65,7 +65,8 @@
.\" POSIX_MODE
set the global variable
.Va errno
-to EDOM.
+to
+.Er EDOM .
.\" SYSV_MODE
.\" call
.\" .Xr matherr 3 .
diff -r 1e1a77716e26 -r d7da74e3622c lib/libm/man/acosh.3
--- a/lib/libm/man/acosh.3 Sun Dec 04 11:18:58 2022 +0000
+++ b/lib/libm/man/acosh.3 Sun Dec 04 11:25:08 2022 +0000
@@ -26,7 +26,7 @@
.\" SUCH DAMAGE.
.\"
.\" from: @(#)acosh.3 5.2 (Berkeley) 5/6/91
-.\" $NetBSD: acosh.3,v 1.17 2014/09/19 16:02:58 wiz Exp $
+.\" $NetBSD: acosh.3,v 1.18 2022/12/04 11:25:09 uwe Exp $
Home |
Main Index |
Thread Index |
Old Index