type, and remove unnecessary parentheses around the casted value.
Thus, for example, the following:
.IR "(size_t) (\-1)" .
becomes:
.IR "(size_t)\ \-1" .
17 files changed:
session leader.)
.SH RETURN VALUE
On success, a session ID is returned.
session leader.)
.SH RETURN VALUE
On success, a session ID is returned.
-On error, \fI(pid_t) \-1\fP will be returned, and
+On error, \fI(pid_t)\ \-1\fP will be returned, and
.I errno
is set appropriately.
.SH ERRORS
.I errno
is set appropriately.
.SH ERRORS
On error, the value
.B MAP_FAILED
(that is,
On error, the value
.B MAP_FAILED
(that is,
is returned, and
.I errno
is set appropriately.
is returned, and
.I errno
is set appropriately.
returns a pointer to the new virtual memory area.
On error, the value
.B MAP_FAILED
returns a pointer to the new virtual memory area.
On error, the value
.B MAP_FAILED
-(that is, \fI(void *) \-1\fP) is returned,
+(that is, \fI(void\ *)\ \-1\fP) is returned,
and \fIerrno\fP is set appropriately.
.SH ERRORS
.TP
and \fIerrno\fP is set appropriately.
.SH ERRORS
.TP
On success
.BR shmat ()
returns the address of the attached shared memory segment; on error
On success
.BR shmat ()
returns the address of the attached shared memory segment; on error
is returned, and
.I errno
is set to indicate the cause of the error.
is returned, and
.I errno
is set to indicate the cause of the error.
.BR CLOCKS_PER_SEC .
If the processor time used is not available or its value cannot
be represented, the function returns the value
.BR CLOCKS_PER_SEC .
If the processor time used is not available or its value cannot
be represented, the function returns the value
.SH "CONFORMING TO"
C89, C99, POSIX.1-2001.
POSIX requires that
.SH "CONFORMING TO"
C89, C99, POSIX.1-2001.
POSIX requires that
time cannot be represented as calendar time (seconds since the Epoch),
.BR mktime ()
returns a value of
time cannot be represented as calendar time (seconds since the Epoch),
.BR mktime ()
returns a value of
and does not alter the
\fItm_wday\fP and \fItm_yday\fP members of the broken-down time structure.
.SH "RETURN VALUE"
and does not alter the
\fItm_wday\fP and \fItm_yday\fP members of the broken-down time structure.
.SH "RETURN VALUE"
1. An invalid multibyte sequence is encountered in the input.
In this case
it sets \fIerrno\fP to \fBEILSEQ\fP and returns
1. An invalid multibyte sequence is encountered in the input.
In this case
it sets \fIerrno\fP to \fBEILSEQ\fP and returns
\fI*inbuf\fP
is left pointing to the beginning of the invalid multibyte sequence.
.PP
\fI*inbuf\fP
is left pointing to the beginning of the invalid multibyte sequence.
.PP
input byte sequence terminates after it.
In this case it sets \fIerrno\fP to
\fBEINVAL\fP and returns
input byte sequence terminates after it.
In this case it sets \fIerrno\fP to
\fBEINVAL\fP and returns
\fI*inbuf\fP is left pointing to the
beginning of the incomplete multibyte sequence.
.PP
4. The output buffer has no more room for the next converted character.
In this case it sets \fIerrno\fP to \fBE2BIG\fP and returns
\fI*inbuf\fP is left pointing to the
beginning of the incomplete multibyte sequence.
.PP
4. The output buffer has no more room for the next converted character.
In this case it sets \fIerrno\fP to \fBE2BIG\fP and returns
.PP
A different case is when \fIinbuf\fP is NULL or \fI*inbuf\fP is NULL, but
\fIoutbuf\fP is not NULL and \fI*outbuf\fP is not NULL.
.PP
A different case is when \fIinbuf\fP is NULL or \fI*inbuf\fP is NULL, but
\fIoutbuf\fP is not NULL and \fI*outbuf\fP is not NULL.
At most \fI*outbytesleft\fP bytes, starting at \fI*outbuf\fP, will be written.
If the output buffer has no more room for this reset sequence, it sets
\fIerrno\fP to \fBE2BIG\fP and returns
At most \fI*outbytesleft\fP bytes, starting at \fI*outbuf\fP, will be written.
If the output buffer has no more room for this reset sequence, it sets
\fIerrno\fP to \fBE2BIG\fP and returns
Otherwise it increments
\fI*outbuf\fP and decrements \fI*outbytesleft\fP by the number of bytes
written.
Otherwise it increments
\fI*outbuf\fP and decrements \fI*outbytesleft\fP by the number of bytes
written.
function returns the number of characters converted in a
non-reversible way during this call; reversible conversions are not counted.
In case of error, it sets \fIerrno\fP and returns
function returns the number of characters converted in a
non-reversible way during this call; reversible conversions are not counted.
In case of error, it sets \fIerrno\fP and returns
.SH ERRORS
The following errors can occur, among others:
.TP
.SH ERRORS
The following errors can occur, among others:
.TP
function returns a freshly allocated conversion
descriptor.
In case of error, it sets \fIerrno\fP and returns
function returns a freshly allocated conversion
descriptor.
In case of error, it sets \fIerrno\fP and returns
.SH ERRORS
The following error can occur, among others:
.TP
.SH ERRORS
The following error can occur, among others:
.TP
If the \fIn\fP bytes starting at \fIs\fP do not contain a complete multibyte
character,
.BR mbrlen ()
If the \fIn\fP bytes starting at \fIs\fP do not contain a complete multibyte
character,
.BR mbrlen ()
-returns \fI(size_t)(\-2)\fP.
+returns \fI(size_t)\ \-2\fP.
This can happen even if
\fIn\fP >= \fIMB_CUR_MAX\fP, if the multibyte string contains redundant shift
sequences.
This can happen even if
\fIn\fP >= \fIMB_CUR_MAX\fP, if the multibyte string contains redundant shift
sequences.
sequence before the next complete character,
.BR mbrlen ()
returns
sequence before the next complete character,
.BR mbrlen ()
returns
-\fI(size_t) \-1\fP and sets \fIerrno\fP to \fBEILSEQ\fP.
+\fI(size_t)\ \-1\fP and sets \fIerrno\fP to \fBEILSEQ\fP.
In this case,
the effects on \fI*ps\fP are undefined.
.PP
In this case,
the effects on \fI*ps\fP are undefined.
.PP
sequence starting at \fIs\fP, if a non-null wide character was recognized.
It returns 0, if a null wide character was recognized.
It returns
sequence starting at \fIs\fP, if a non-null wide character was recognized.
It returns 0, if a null wide character was recognized.
It returns
and sets \fIerrno\fP to \fBEILSEQ\fP, if an invalid multibyte sequence was
encountered.
and sets \fIerrno\fP to \fBEILSEQ\fP, if an invalid multibyte sequence was
encountered.
-It returns \fI(size_t)(\-2)\fP if it couldn't parse a complete multibyte
+It returns \fI(size_t)\ \-2\fP if it couldn't parse a complete multibyte
character, meaning that \fIn\fP should be increased.
.SH "CONFORMING TO"
C99
character, meaning that \fIn\fP should be increased.
.SH "CONFORMING TO"
C99
If the \fIn\fP bytes starting at \fIs\fP do not contain a complete multibyte
character,
.BR mbrtowc ()
If the \fIn\fP bytes starting at \fIs\fP do not contain a complete multibyte
character,
.BR mbrtowc ()
-returns \fI(size_t)(\-2)\fP.
+returns \fI(size_t)\ \-2\fP.
This can happen even if
\fIn\fP >= \fIMB_CUR_MAX\fP, if the multibyte string contains redundant shift
sequences.
This can happen even if
\fIn\fP >= \fIMB_CUR_MAX\fP, if the multibyte string contains redundant shift
sequences.
was recognized.
It returns 0, if a L'\\0' wide character was recognized.
It returns
was recognized.
It returns 0, if a L'\\0' wide character was recognized.
It returns
and sets \fIerrno\fP to \fBEILSEQ\fP, if an invalid multibyte sequence was
encountered.
and sets \fIerrno\fP to \fBEILSEQ\fP, if an invalid multibyte sequence was
encountered.
-It returns \fI(size_t)(\-2)\fP if it couldn't parse a complete multibyte
+It returns \fI(size_t)\ \-2\fP if it couldn't parse a complete multibyte
character, meaning that \fIn\fP should be increased.
.SH "CONFORMING TO"
C99
character, meaning that \fIn\fP should be increased.
.SH "CONFORMING TO"
C99
1. An invalid multibyte sequence has been encountered.
In this case \fI*src\fP
is left pointing to the invalid multibyte sequence,
1. An invalid multibyte sequence has been encountered.
In this case \fI*src\fP
is left pointing to the invalid multibyte sequence,
is returned,
and \fIerrno\fP is set to \fBEILSEQ\fP.
.PP
is returned,
and \fIerrno\fP is set to \fBEILSEQ\fP.
.PP
not including the terminating null wide character.
If an invalid multibyte sequence was
encountered,
not including the terminating null wide character.
If an invalid multibyte sequence was
encountered,
is returned, and \fIerrno\fP set to \fBEILSEQ\fP.
.SH "CONFORMING TO"
This function is a GNU extension.
is returned, and \fIerrno\fP set to \fBEILSEQ\fP.
.SH "CONFORMING TO"
This function is a GNU extension.
1. An invalid multibyte sequence has been encountered.
In this case \fI*src\fP
is left pointing to the invalid multibyte sequence,
1. An invalid multibyte sequence has been encountered.
In this case \fI*src\fP
is left pointing to the invalid multibyte sequence,
is returned,
and \fIerrno\fP is set to \fBEILSEQ\fP.
.PP
is returned,
and \fIerrno\fP is set to \fBEILSEQ\fP.
.PP
terminating null wide character.
If an invalid multibyte sequence was
encountered,
terminating null wide character.
If an invalid multibyte sequence was
encountered,
is returned, and \fIerrno\fP set to \fBEILSEQ\fP.
.SH "CONFORMING TO"
C99
is returned, and \fIerrno\fP set to \fBEILSEQ\fP.
.SH "CONFORMING TO"
C99
.PP
1. An invalid multibyte sequence has been encountered.
In this case
.PP
1. An invalid multibyte sequence has been encountered.
In this case
is returned.
.PP
2. \fIn\fP non-L'\\0' wide characters have been stored at \fIdest\fP.
is returned.
.PP
2. \fIn\fP non-L'\\0' wide characters have been stored at \fIdest\fP.
terminating null wide character.
If an invalid multibyte sequence was
encountered,
terminating null wide character.
If an invalid multibyte sequence was
encountered,
is returned.
.SH "CONFORMING TO"
C99
is returned.
.SH "CONFORMING TO"
C99
have been written to the byte array at \fIs\fP.
If \fIwc\fP can not be
represented as a multibyte sequence (according to the current locale),
have been written to the byte array at \fIs\fP.
If \fIwc\fP can not be
represented as a multibyte sequence (according to the current locale),
is returned, and \fIerrno\fP set to \fBEILSEQ\fP.
.SH "CONFORMING TO"
C99.
is returned, and \fIerrno\fP set to \fBEILSEQ\fP.
.SH "CONFORMING TO"
C99.
multibyte sequence (according to the current locale).
In this case \fI*src\fP
is left pointing to the invalid wide character,
multibyte sequence (according to the current locale).
In this case \fI*src\fP
is left pointing to the invalid wide character,
is returned,
and \fIerrno\fP is set to \fBEILSEQ\fP.
.PP
is returned,
and \fIerrno\fP is set to \fBEILSEQ\fP.
.PP
not including the terminating null byte.
If a wide character was encountered which
could not be converted,
not including the terminating null byte.
If a wide character was encountered which
could not be converted,
is returned, and \fIerrno\fP set to \fBEILSEQ\fP.
.SH "CONFORMING TO"
This function is a GNU extension.
is returned, and \fIerrno\fP set to \fBEILSEQ\fP.
.SH "CONFORMING TO"
This function is a GNU extension.
multibyte sequence (according to the current locale).
In this case \fI*src\fP
is left pointing to the invalid wide character,
multibyte sequence (according to the current locale).
In this case \fI*src\fP
is left pointing to the invalid wide character,
is returned,
and
.I errno
is returned,
and
.I errno
not including the terminating null byte.
If a wide character was encountered
which could not be converted,
not including the terminating null byte.
If a wide character was encountered
which could not be converted,
is returned, and
.I errno
set to \fBEILSEQ\fP.
is returned, and
.I errno
set to \fBEILSEQ\fP.
1. A wide character has been encountered that can not be represented as a
multibyte sequence (according to the current locale).
In this case
1. A wide character has been encountered that can not be represented as a
multibyte sequence (according to the current locale).
In this case
is returned.
.PP
2. The length limit forces a stop.
is returned.
.PP
2. The length limit forces a stop.
converted part of multibyte sequence, not including the terminating null byte.
If a wide character was encountered which could not be
converted,
converted part of multibyte sequence, not including the terminating null byte.
If a wide character was encountered which could not be
converted,
is returned.
.SH "CONFORMING TO"
C99.
is returned.
.SH "CONFORMING TO"
C99.