summaryrefslogtreecommitdiff
path: root/lib/libc/string
diff options
context:
space:
mode:
authorIngo Schwarze <schwarze@cvs.openbsd.org>2019-05-16 13:35:18 +0000
committerIngo Schwarze <schwarze@cvs.openbsd.org>2019-05-16 13:35:18 +0000
commit1b68ae694a3627fa8c926fea31651ed2fafbd75e (patch)
treeee5423dc11c3f0aba3fd1cae657ee6975560ee6a /lib/libc/string
parent3d0c792004dccce0a87f3c922e4c515acfc40b7b (diff)
More consistently put remarks about the less useful LC_* categoties,
i.e. those other than LC_CTYPE, into the CAVEATS section, and standardize wording somewhat. OK jmc@
Diffstat (limited to 'lib/libc/string')
-rw-r--r--lib/libc/string/strerror.322
-rw-r--r--lib/libc/string/strsignal.318
2 files changed, 26 insertions, 14 deletions
diff --git a/lib/libc/string/strerror.3 b/lib/libc/string/strerror.3
index 0d4f084e5e0..6c5b890fa4c 100644
--- a/lib/libc/string/strerror.3
+++ b/lib/libc/string/strerror.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: strerror.3,v 1.15 2017/09/05 03:16:13 schwarze Exp $
+.\" $OpenBSD: strerror.3,v 1.16 2019/05/16 13:35:16 schwarze Exp $
.\"
.\" Copyright (c) 1980, 1991 Regents of the University of California.
.\" Copyright (c) 2017 Ingo Schwarze <schwarze@openbsd.org>
@@ -32,7 +32,7 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: September 5 2017 $
+.Dd $Mdocdate: May 16 2019 $
.Dt STRERROR 3
.Os
.Sh NAME
@@ -95,14 +95,6 @@ returns zero upon successful completion.
If an error occurs, the error code is stored in
.Va errno
and the error code is returned.
-.Sh ENVIRONMENT
-On other operating systems, the behaviour of
-.Fn strerror
-and
-.Fn strerror_r
-may depend on the
-.Dv LC_MESSAGES
-.Xr locale 1 .
.Sh ERRORS
All these functions may fail if:
.Bl -tag -width Er
@@ -150,3 +142,13 @@ and
.Fn strerror_l
since
.Ox 6.2 .
+.Sh CAVEATS
+On systems other than
+.Ox ,
+the
+.Dv LC_MESSAGES
+.Xr locale 1
+category can cause different strings to be returned instead of the
+normal error messages; see CAVEATS in
+.Xr setlocale 3
+for details.
diff --git a/lib/libc/string/strsignal.3 b/lib/libc/string/strsignal.3
index 3261f699d88..b46be893b52 100644
--- a/lib/libc/string/strsignal.3
+++ b/lib/libc/string/strsignal.3
@@ -29,9 +29,9 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.\" $OpenBSD: strsignal.3,v 1.8 2013/06/05 03:39:23 tedu Exp $
+.\" $OpenBSD: strsignal.3,v 1.9 2019/05/16 13:35:16 schwarze Exp $
.\"
-.Dd $Mdocdate: June 5 2013 $
+.Dd $Mdocdate: May 16 2019 $
.Dt STRSIGNAL 3
.Os
.Sh NAME
@@ -44,8 +44,8 @@
.Sh DESCRIPTION
The
.Fn strsignal
-function returns a pointer to the language-dependent string describing
-a signal.
+function returns a pointer to the string describing the signal
+.Fa sig .
.Pp
The array pointed to is not to be modified by the program, but may be
overwritten by subsequent calls to
@@ -66,3 +66,13 @@ function first appeared in
.At V.4
and was reimplemented for
.Nx 1.0 .
+.Sh CAVEATS
+On systems other than
+.Ox ,
+the
+.Dv LC_MESSAGES
+.Xr locale 1
+category can cause different strings to be returned instead of the
+normal signal descriptions; see CAVEATS in
+.Xr setlocale 3
+for details.