Browse Source

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@
OPENBSD_6_6
schwarze 5 years ago
parent
commit
c39a22b840
2 changed files with 26 additions and 14 deletions
  1. +12
    -10
      src/lib/libc/string/strerror.3
  2. +14
    -4
      src/lib/libc/string/strsignal.3

+ 12
- 10
src/lib/libc/string/strerror.3 View File

@ -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) 1980, 1991 Regents of the University of California.
.\" Copyright (c) 2017 Ingo Schwarze <schwarze@openbsd.org> .\" 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 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE. .\" SUCH DAMAGE.
.\" .\"
.Dd $Mdocdate: September 5 2017 $
.Dd $Mdocdate: May 16 2019 $
.Dt STRERROR 3 .Dt STRERROR 3
.Os .Os
.Sh NAME .Sh NAME
@ -95,14 +95,6 @@ returns zero upon successful completion.
If an error occurs, the error code is stored in If an error occurs, the error code is stored in
.Va errno .Va errno
and the error code is returned. 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 .Sh ERRORS
All these functions may fail if: All these functions may fail if:
.Bl -tag -width Er .Bl -tag -width Er
@ -150,3 +142,13 @@ and
.Fn strerror_l .Fn strerror_l
since since
.Ox 6.2 . .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.

+ 14
- 4
src/lib/libc/string/strsignal.3 View File

@ -29,9 +29,9 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE. .\" 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 .Dt STRSIGNAL 3
.Os .Os
.Sh NAME .Sh NAME
@ -44,8 +44,8 @@
.Sh DESCRIPTION .Sh DESCRIPTION
The The
.Fn strsignal .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 .Pp
The array pointed to is not to be modified by the program, but may be The array pointed to is not to be modified by the program, but may be
overwritten by subsequent calls to overwritten by subsequent calls to
@ -66,3 +66,13 @@ function first appeared in
.At V.4 .At V.4
and was reimplemented for and was reimplemented for
.Nx 1.0 . .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.

Loading…
Cancel
Save