Format casts so that there is a non-breaking space after the

type, and remove unnecessary parentheses around the casted value.
Thus, for example, the following:

     .IR "(size_t) (\-1)" .

becomes:
    .IR "(size_t)\ \-1" .
This commit is contained in:
Michael Kerrisk 2007-12-22 16:26:51 +00:00
parent a574189c5f
commit 009df872f7
17 changed files with 32 additions and 32 deletions

View File

@ -47,7 +47,7 @@ returns the session ID of the process with process ID
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

View File

@ -327,7 +327,7 @@ returns a pointer to the mapped area.
On error, the value
.B MAP_FAILED
(that is,
.IR "(void *) \-1" )
.IR "(void\ *)\ \-1" )
is returned, and
.I errno
is set appropriately.

View File

@ -125,7 +125,7 @@ On success
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

View File

@ -170,7 +170,7 @@ all attached shared memory segments are detached from the process.
On success
.BR shmat ()
returns the address of the attached shared memory segment; on error
.I (void *) \-1
.I (void\ *)\ \-1
is returned, and
.I errno
is set to indicate the cause of the error.

View File

@ -44,7 +44,7 @@ to get the number of seconds used, divide by
.BR CLOCKS_PER_SEC .
If the processor time used is not available or its value cannot
be represented, the function returns the value
.IR (clock_t)\-1 .
.IR (clock_t)\ \-1 .
.SH "CONFORMING TO"
C89, C99, POSIX.1-2001.
POSIX requires that

View File

@ -232,7 +232,7 @@ If the specified broken-down
time cannot be represented as calendar time (seconds since the Epoch),
.BR mktime ()
returns a value of
.I (time_t)(\-1)
.I (time_t)\ \-1
and does not alter the
\fItm_wday\fP and \fItm_yday\fP members of the broken-down time structure.
.SH "RETURN VALUE"

View File

@ -49,7 +49,7 @@ The conversion can stop for four reasons:
1. An invalid multibyte sequence is encountered in the input.
In this case
it sets \fIerrno\fP to \fBEILSEQ\fP and returns
.IR (size_t)(\-1) .
.IR (size_t)\ \-1 .
\fI*inbuf\fP
is left pointing to the beginning of the invalid multibyte sequence.
.PP
@ -64,13 +64,13 @@ non-reversible conversions performed during this call.
input byte sequence terminates after it.
In this case it sets \fIerrno\fP to
\fBEINVAL\fP and returns
.IR (size_t)(\-1) .
.IR (size_t)\ \-1 .
\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
.IR (size_t)(\-1) .
.IR (size_t)\ \-1 .
.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.
@ -81,7 +81,7 @@ initial state and store a corresponding shift sequence at \fI*outbuf\fP.
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
.IR (size_t)(\-1) .
.IR (size_t)\ \-1 .
Otherwise it increments
\fI*outbuf\fP and decrements \fI*outbytesleft\fP by the number of bytes
written.
@ -97,7 +97,7 @@ The
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
.IR (size_t)(\-1) .
.IR (size_t)\ \-1 .
.SH ERRORS
The following errors can occur, among others:
.TP

View File

@ -72,7 +72,7 @@ The
function returns a freshly allocated conversion
descriptor.
In case of error, it sets \fIerrno\fP and returns
.IR (iconv_t)(\-1) .
.IR (iconv_t)\ \-1 .
.SH ERRORS
The following error can occur, among others:
.TP

View File

@ -35,7 +35,7 @@ shift state \fI*ps\fP to the initial state and returns 0.
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.
@ -44,7 +44,7 @@ If the multibyte string starting at \fIs\fP contains an invalid multibyte
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
@ -59,10 +59,10 @@ parsed from the multibyte
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
.I "(size_t) \-1"
.I "(size_t)\ \-1"
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

View File

@ -40,7 +40,7 @@ state \fI*ps\fP to the initial state and returns 0.
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.
@ -91,10 +91,10 @@ multibyte sequence starting at \fIs\fP, if a non-L'\\0' wide character
was recognized.
It returns 0, if a L'\\0' wide character was recognized.
It returns
.I (size_t)(\-1)
.I (size_t)\ \-1
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

View File

@ -50,7 +50,7 @@ conversion can stop for three reasons:
1. An invalid multibyte sequence has been encountered.
In this case \fI*src\fP
is left pointing to the invalid multibyte sequence,
.I (size_t)(\-1)
.I (size_t)\ \-1
is returned,
and \fIerrno\fP is set to \fBEILSEQ\fP.
.PP
@ -85,7 +85,7 @@ that make up the converted part of the wide-character string,
not including the terminating null wide character.
If an invalid multibyte sequence was
encountered,
.I (size_t)(\-1)
.I (size_t)\ \-1
is returned, and \fIerrno\fP set to \fBEILSEQ\fP.
.SH "CONFORMING TO"
This function is a GNU extension.

View File

@ -40,7 +40,7 @@ The conversion can stop for three reasons:
1. An invalid multibyte sequence has been encountered.
In this case \fI*src\fP
is left pointing to the invalid multibyte sequence,
.I (size_t)(\-1)
.I (size_t)\ \-1
is returned,
and \fIerrno\fP is set to \fBEILSEQ\fP.
.PP
@ -79,7 +79,7 @@ up the converted part of the wide-character string, not including the
terminating null wide character.
If an invalid multibyte sequence was
encountered,
.I (size_t)(\-1)
.I (size_t)\ \-1
is returned, and \fIerrno\fP set to \fBEILSEQ\fP.
.SH "CONFORMING TO"
C99

View File

@ -33,7 +33,7 @@ The conversion can stop for three reasons:
.PP
1. An invalid multibyte sequence has been encountered.
In this case
.I (size_t)(\-1)
.I (size_t)\ \-1
is returned.
.PP
2. \fIn\fP non-L'\\0' wide characters have been stored at \fIdest\fP.
@ -63,7 +63,7 @@ up the converted part of the wide-character string, not including the
terminating null wide character.
If an invalid multibyte sequence was
encountered,
.I (size_t)(\-1)
.I (size_t)\ \-1
is returned.
.SH "CONFORMING TO"
C99

View File

@ -67,7 +67,7 @@ bytes that have been or would
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),
.I (size_t)(\-1)
.I (size_t)\ \-1
is returned, and \fIerrno\fP set to \fBEILSEQ\fP.
.SH "CONFORMING TO"
C99.

View File

@ -53,7 +53,7 @@ The conversion can stop for three reasons:
multibyte sequence (according to the current locale).
In this case \fI*src\fP
is left pointing to the invalid wide character,
.I (size_t)(\-1)
.I (size_t)\ \-1
is returned,
and \fIerrno\fP is set to \fBEILSEQ\fP.
.PP
@ -91,7 +91,7 @@ converted part of multibyte sequence,
not including the terminating null byte.
If a wide character was encountered which
could not be converted,
.I (size_t)(\-1)
.I (size_t)\ \-1
is returned, and \fIerrno\fP set to \fBEILSEQ\fP.
.SH "CONFORMING TO"
This function is a GNU extension.

View File

@ -44,7 +44,7 @@ The conversion can stop for three reasons:
multibyte sequence (according to the current locale).
In this case \fI*src\fP
is left pointing to the invalid wide character,
.I (size_t)(\-1)
.I (size_t)\ \-1
is returned,
and
.I errno
@ -83,7 +83,7 @@ converted part of multibyte sequence,
not including the terminating null byte.
If a wide character was encountered
which could not be converted,
.I (size_t)(\-1)
.I (size_t)\ \-1
is returned, and
.I errno
set to \fBEILSEQ\fP.

View File

@ -34,7 +34,7 @@ The conversion can stop for three reasons:
1. A wide character has been encountered that can not be represented as a
multibyte sequence (according to the current locale).
In this case
.I (size_t)(\-1)
.I (size_t)\ \-1
is returned.
.PP
2. The length limit forces a stop.
@ -63,7 +63,7 @@ function returns the number of bytes that make up the
converted part of multibyte sequence, not including the terminating null byte.
If a wide character was encountered which could not be
converted,
.I (size_t)(\-1)
.I (size_t)\ \-1
is returned.
.SH "CONFORMING TO"
C99.