Mercurial > hg > octave-nkf > gnulib-hg

annotate doc/posix-functions/strerror.texi @ 17608:63e4133ca82e

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
relocatable-maint.texi: escape braces The change causes makeinfo 5.2 to fail: env LANG= LC_MESSAGES= LC_ALL= LANGUAGE= makeinfo --no-split --reference-limit=2000 gnulib.texi ./relocatable-maint.texi:153: misplaced { ... Escaping the braces as per the attached patch seems to fix this.
author Daniel Albers <daniel@lbe.rs>
date Thu, 16 Jan 2014 12:56:52 +0100
parents 498a2211d839
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
9638
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
1 @node strerror
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
2 @section @code{strerror}
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
3 @findex strerror
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
4
13549
bb0ceefd22dc avoid some overlong lines from posix urls, etc.
Karl Berry <karl@freefriends.org>
parents: 13148
diff changeset
5 POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/strerror.html}
9638
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
6
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
7 Gnulib module: strerror
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
8
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
9 Portability problems fixed by Gnulib:
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
10 @itemize
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
11 @item
10429
69d9922a5bd2 Extend strerror to cover the added errno values.
Bruno Haible <bruno@clisp.org>
parents: 9638
diff changeset
12 This function does not support the error values that are specified by POSIX
69d9922a5bd2 Extend strerror to cover the added errno values.
Bruno Haible <bruno@clisp.org>
parents: 9638
diff changeset
13 but not defined by the system, on some platforms:
15607
6355dc4626b5 doc: Update regarding MSVC 9.
Bruno Haible <bruno@clisp.org>
parents: 15308
diff changeset
14 OpenBSD 4.0, OSF/1 5.1, NonStop Kernel, Cygwin 1.5.x, mingw, MSVC 9.
9638
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
15 @item
14895
66b65ce5da39 strerror_r-posix: fix on MacOS
Eric Blake <eblake@redhat.com>
parents: 14762
diff changeset
16 This function reports failure for @code{strerror(0)} (by setting
66b65ce5da39 strerror_r-posix: fix on MacOS
Eric Blake <eblake@redhat.com>
parents: 14762
diff changeset
17 @code{errno} or using a string similar to out-of-range values),
66b65ce5da39 strerror_r-posix: fix on MacOS
Eric Blake <eblake@redhat.com>
parents: 14762
diff changeset
18 although POSIX requires this to leave @code{errno} unchanged and
66b65ce5da39 strerror_r-posix: fix on MacOS
Eric Blake <eblake@redhat.com>
parents: 14762
diff changeset
19 report success, on some platforms:
16935
498a2211d839 Write "Mac OS X" instead of "MacOS X".
Bruno Haible <bruno@clisp.org>
parents: 15607
diff changeset
20 FreeBSD 8.2, OpenBSD 4.7, Mac OS X 10.5.
14762
3c012e3d3f43 strerror: enforce POSIX ruling on strerror(0)
Eric Blake <eblake@redhat.com>
parents: 13844
diff changeset
21 @item
9638
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
22 This function fails to return a string for out-of-range integers on
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
23 some platforms:
13844
d75056826e59 doc: List more failing platforms.
Bruno Haible <bruno@clisp.org>
parents: 13843
diff changeset
24 HP-UX 11, IRIX 6.5, Solaris 8.
14762
3c012e3d3f43 strerror: enforce POSIX ruling on strerror(0)
Eric Blake <eblake@redhat.com>
parents: 13844
diff changeset
25 (Some return NULL which is a POSIX violation, others return the empty
3c012e3d3f43 strerror: enforce POSIX ruling on strerror(0)
Eric Blake <eblake@redhat.com>
parents: 13844
diff changeset
26 string which is valid but not as useful); this can still cause bugs
3c012e3d3f43 strerror: enforce POSIX ruling on strerror(0)
Eric Blake <eblake@redhat.com>
parents: 13844
diff changeset
27 because most programs call @code{strerror} without setting and testing
3c012e3d3f43 strerror: enforce POSIX ruling on strerror(0)
Eric Blake <eblake@redhat.com>
parents: 13844
diff changeset
28 @code{errno}.)
9638
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
29 @end itemize
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
30
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
31 Portability problems not fixed by Gnulib:
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
32 @itemize
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
33 @end itemize