diff options
author | schwarze <> | 2019-05-16 13:35:16 +0000 |
---|---|---|
committer | schwarze <> | 2019-05-16 13:35:16 +0000 |
commit | 656919abadeb5a96c2594db38952c4073b401577 (patch) | |
tree | ee3d8ae2187ff7f0d5efb64053bda8791c07e84f | |
parent | e93f132f9ace4d42865eb3dc1477aed0ab150a46 (diff) | |
download | openbsd-656919abadeb5a96c2594db38952c4073b401577.tar.gz openbsd-656919abadeb5a96c2594db38952c4073b401577.tar.bz2 openbsd-656919abadeb5a96c2594db38952c4073b401577.zip |
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@
-rw-r--r-- | src/lib/libc/string/strerror.3 | 22 | ||||
-rw-r--r-- | src/lib/libc/string/strsignal.3 | 18 |
2 files changed, 26 insertions, 14 deletions
diff --git a/src/lib/libc/string/strerror.3 b/src/lib/libc/string/strerror.3 index 0d4f084e5e..6c5b890fa4 100644 --- a/src/lib/libc/string/strerror.3 +++ b/src/lib/libc/string/strerror.3 | |||
@@ -1,4 +1,4 @@ | |||
1 | .\" $OpenBSD: strerror.3,v 1.15 2017/09/05 03:16:13 schwarze Exp $ | 1 | .\" $OpenBSD: strerror.3,v 1.16 2019/05/16 13:35:16 schwarze Exp $ |
2 | .\" | 2 | .\" |
3 | .\" Copyright (c) 1980, 1991 Regents of the University of California. | 3 | .\" Copyright (c) 1980, 1991 Regents of the University of California. |
4 | .\" Copyright (c) 2017 Ingo Schwarze <schwarze@openbsd.org> | 4 | .\" Copyright (c) 2017 Ingo Schwarze <schwarze@openbsd.org> |
@@ -32,7 +32,7 @@ | |||
32 | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | 32 | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF |
33 | .\" SUCH DAMAGE. | 33 | .\" SUCH DAMAGE. |
34 | .\" | 34 | .\" |
35 | .Dd $Mdocdate: September 5 2017 $ | 35 | .Dd $Mdocdate: May 16 2019 $ |
36 | .Dt STRERROR 3 | 36 | .Dt STRERROR 3 |
37 | .Os | 37 | .Os |
38 | .Sh NAME | 38 | .Sh NAME |
@@ -95,14 +95,6 @@ returns zero upon successful completion. | |||
95 | If an error occurs, the error code is stored in | 95 | If an error occurs, the error code is stored in |
96 | .Va errno | 96 | .Va errno |
97 | and the error code is returned. | 97 | and the error code is returned. |
98 | .Sh ENVIRONMENT | ||
99 | On other operating systems, the behaviour of | ||
100 | .Fn strerror | ||
101 | and | ||
102 | .Fn strerror_r | ||
103 | may depend on the | ||
104 | .Dv LC_MESSAGES | ||
105 | .Xr locale 1 . | ||
106 | .Sh ERRORS | 98 | .Sh ERRORS |
107 | All these functions may fail if: | 99 | All these functions may fail if: |
108 | .Bl -tag -width Er | 100 | .Bl -tag -width Er |
@@ -150,3 +142,13 @@ and | |||
150 | .Fn strerror_l | 142 | .Fn strerror_l |
151 | since | 143 | since |
152 | .Ox 6.2 . | 144 | .Ox 6.2 . |
145 | .Sh CAVEATS | ||
146 | On systems other than | ||
147 | .Ox , | ||
148 | the | ||
149 | .Dv LC_MESSAGES | ||
150 | .Xr locale 1 | ||
151 | category can cause different strings to be returned instead of the | ||
152 | normal error messages; see CAVEATS in | ||
153 | .Xr setlocale 3 | ||
154 | for details. | ||
diff --git a/src/lib/libc/string/strsignal.3 b/src/lib/libc/string/strsignal.3 index 3261f699d8..b46be893b5 100644 --- a/src/lib/libc/string/strsignal.3 +++ b/src/lib/libc/string/strsignal.3 | |||
@@ -29,9 +29,9 @@ | |||
29 | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | 29 | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF |
30 | .\" SUCH DAMAGE. | 30 | .\" SUCH DAMAGE. |
31 | .\" | 31 | .\" |
32 | .\" $OpenBSD: strsignal.3,v 1.8 2013/06/05 03:39:23 tedu Exp $ | 32 | .\" $OpenBSD: strsignal.3,v 1.9 2019/05/16 13:35:16 schwarze Exp $ |
33 | .\" | 33 | .\" |
34 | .Dd $Mdocdate: June 5 2013 $ | 34 | .Dd $Mdocdate: May 16 2019 $ |
35 | .Dt STRSIGNAL 3 | 35 | .Dt STRSIGNAL 3 |
36 | .Os | 36 | .Os |
37 | .Sh NAME | 37 | .Sh NAME |
@@ -44,8 +44,8 @@ | |||
44 | .Sh DESCRIPTION | 44 | .Sh DESCRIPTION |
45 | The | 45 | The |
46 | .Fn strsignal | 46 | .Fn strsignal |
47 | function returns a pointer to the language-dependent string describing | 47 | function returns a pointer to the string describing the signal |
48 | a signal. | 48 | .Fa sig . |
49 | .Pp | 49 | .Pp |
50 | The array pointed to is not to be modified by the program, but may be | 50 | The array pointed to is not to be modified by the program, but may be |
51 | overwritten by subsequent calls to | 51 | overwritten by subsequent calls to |
@@ -66,3 +66,13 @@ function first appeared in | |||
66 | .At V.4 | 66 | .At V.4 |
67 | and was reimplemented for | 67 | and was reimplemented for |
68 | .Nx 1.0 . | 68 | .Nx 1.0 . |
69 | .Sh CAVEATS | ||
70 | On systems other than | ||
71 | .Ox , | ||
72 | the | ||
73 | .Dv LC_MESSAGES | ||
74 | .Xr locale 1 | ||
75 | category can cause different strings to be returned instead of the | ||
76 | normal signal descriptions; see CAVEATS in | ||
77 | .Xr setlocale 3 | ||
78 | for details. | ||