aboutsummaryrefslogtreecommitdiffstats
path: root/man3
diff options
context:
space:
mode:
authorMichael Kerrisk <mtk.manpages@gmail.com>2007-06-08 11:56:22 +0000
committerMichael Kerrisk <mtk.manpages@gmail.com>2007-06-08 11:56:22 +0000
commit75b94dc35ca88fc72d0381c72c535180851bf08f (patch)
tree107dfea45855463eaa970ccff1b6074c305ac09a /man3
parentca7b3c180c14583f36bf24c7f31cc8ba342e23d8 (diff)
downloadman-pages-75b94dc35ca88fc72d0381c72c535180851bf08f.tar.gz
Change "e.g. " to "e.g., ", or in some cases, "for example, ".
Change "i.e. " to i.e.., ", or in some cases, "that is, ".
Diffstat (limited to 'man3')
-rw-r--r--man3/btree.35
-rw-r--r--man3/ctime.32
-rw-r--r--man3/dbopen.33
-rw-r--r--man3/drand48_r.32
-rw-r--r--man3/ether_aton.32
-rw-r--r--man3/fclose.32
-rw-r--r--man3/fenv.36
-rw-r--r--man3/fflush.32
-rw-r--r--man3/ffs.32
-rw-r--r--man3/fts.36
-rw-r--r--man3/fwide.32
-rw-r--r--man3/gethostbyname.34
-rw-r--r--man3/grantpt.32
-rw-r--r--man3/iconv.34
-rw-r--r--man3/insque.32
-rw-r--r--man3/isalpha.32
-rw-r--r--man3/posix_memalign.34
-rw-r--r--man3/printf.34
-rw-r--r--man3/recno.32
-rw-r--r--man3/scanf.32
-rw-r--r--man3/setlocale.34
-rw-r--r--man3/stdarg.32
-rw-r--r--man3/strfmon.32
-rw-r--r--man3/strftime.34
-rw-r--r--man3/strptime.32
-rw-r--r--man3/termios.32
-rw-r--r--man3/wcpncpy.32
-rw-r--r--man3/wcrtomb.36
-rw-r--r--man3/wcstok.32
-rw-r--r--man3/wctomb.32
-rw-r--r--man3/wprintf.32
31 files changed, 46 insertions, 44 deletions
diff --git a/man3/btree.3 b/man3/btree.3
index 4e3c2f36cc..b31525a0ab 100644
--- a/man3/btree.3
+++ b/man3/btree.3
@@ -87,7 +87,8 @@ any of the following values:
.RS
.TP
R_DUP
-Permit duplicate keys in the tree, i.e. permit insertion if the key to be
+Permit duplicate keys in the tree, that is,
+permit insertion if the key to be
inserted already exists in the tree.
The default behavior, as described in
.BR dbopen (3),
@@ -136,7 +137,7 @@ Not currently implemented.
minkeypage
The minimum number of keys which will be stored on any single page.
This value is used to determine which keys will be stored on overflow
-pages, i.e. if a key or data item is longer than the pagesize divided
+pages, that is, if a key or data item is longer than the pagesize divided
by the minkeypage value, it will be stored on overflow pages instead
of in the page itself.
If
diff --git a/man3/ctime.3 b/man3/ctime.3
index 3f33c42c84..0cd8c1b830 100644
--- a/man3/ctime.3
+++ b/man3/ctime.3
@@ -211,7 +211,7 @@ the specified contents of the structure members \fItm_wday\fP and \fItm_yday\fP
and recomputes them from the other information in the broken-down time
structure.
If structure members are outside their legal interval, they will be
-normalized (so that, e.g., 40 October is changed into 9 November).
+normalized (so that, for example, 40 October is changed into 9 November).
Calling
.BR mktime ()
also sets the external variable \fItzname\fP with
diff --git a/man3/dbopen.3 b/man3/dbopen.3
index 9f14977095..7d30b07ad7 100644
--- a/man3/dbopen.3
+++ b/man3/dbopen.3
@@ -290,7 +290,8 @@ or
.I sync
routines.
Modifications to the database during a sequential scan will be reflected
-in the scan, i.e. records inserted behind the cursor will not be returned
+in the scan, that is,
+records inserted behind the cursor will not be returned
while records inserted in front of the cursor will be returned.
.IP
The flag value
diff --git a/man3/drand48_r.3 b/man3/drand48_r.3
index 68e14b07a7..e47e450dd2 100644
--- a/man3/drand48_r.3
+++ b/man3/drand48_r.3
@@ -66,7 +66,7 @@ Instead of modifying the global random generator state, they use
the supplied data
.IR buffer .
-Before the first use, this struct must be initialized, e.g.
+Before the first use, this struct must be initialized, for example,
by filling it with zeroes, or by calling one of the functions
.BR srand48_r (),
.BR seed48_r (),
diff --git a/man3/ether_aton.3 b/man3/ether_aton.3
index 7960e8e846..e4927ae749 100644
--- a/man3/ether_aton.3
+++ b/man3/ether_aton.3
@@ -95,7 +95,7 @@ hostname; '#' introduces a comment) and returns an address
and hostname pair, or non-zero if it cannot be parsed.
The buffer pointed to by
.I hostname
-must be sufficiently long, e.g., have the same length as
+must be sufficiently long, for example, have the same length as
.IR line .
.PP
The functions
diff --git a/man3/fclose.3 b/man3/fclose.3
index 2fb0731d9c..e6d96624be 100644
--- a/man3/fclose.3
+++ b/man3/fclose.3
@@ -93,7 +93,7 @@ Note that
only flushes the user space buffers provided by the
C library.
To ensure that the data is physically stored
-on disk the kernel buffers must be flushed too, e.g. with
+on disk the kernel buffers must be flushed too, for example, with
.BR sync (2)
or
.BR fsync (2).
diff --git a/man3/fenv.3 b/man3/fenv.3
index e2d22e09bd..4d1c0bd6a6 100644
--- a/man3/fenv.3
+++ b/man3/fenv.3
@@ -95,7 +95,7 @@ Each of the macros
is defined when the implementation supports handling
of the corresponding exception, and if so then
defines the corresponding bit(s), so that one can call
-exception handling functions e.g. using the integer argument
+exception handling functions, for example, using the integer argument
.BR FE_OVERFLOW | FE_UNDERFLOW .
Other exceptions may be supported.
The macro
@@ -185,7 +185,7 @@ The
function restores the floating point environment from
the object
.RI * envp .
-This object must be known to be valid, e.g., the result of a call to
+This object must be known to be valid, for example, the result of a call to
.BR fegetenv ()
or
.BR feholdexcept ()
@@ -224,7 +224,7 @@ It is only defined if
.B _GNU_SOURCE
is defined.
The C99 standard does not define a way to set individual bits in the
-floating point mask, e.g. to trap on specific flags.
+floating point mask, for example, to trap on specific flags.
glibc 2.2 supports the functions
.BR feenableexcept ()
and
diff --git a/man3/fflush.3 b/man3/fflush.3
index 2d401868a4..a1138a1902 100644
--- a/man3/fflush.3
+++ b/man3/fflush.3
@@ -91,7 +91,7 @@ Note that
.BR fflush ()
only flushes the user space buffers provided by the C library.
To ensure that the data is physically stored on disk
-the kernel buffers must be flushed too, e.g. with
+the kernel buffers must be flushed too, for example, with
.BR sync (2)
or
.BR fsync (2).
diff --git a/man3/ffs.3 b/man3/ffs.3
index c1581ecb75..cec1ef2032 100644
--- a/man3/ffs.3
+++ b/man3/ffs.3
@@ -51,7 +51,7 @@ The
function returns the position of the first
(least significant) bit set in the word \fIi\fP.
The least significant bit is position 1 and the
-most significant position e.g. 32 or 64.
+most significant position is, for example, 32 or 64.
.BR
The functions
.BR ffsll ()
diff --git a/man3/fts.3 b/man3/fts.3
index 131e35d22e..979f708eaa 100644
--- a/man3/fts.3
+++ b/man3/fts.3
@@ -174,7 +174,7 @@ A directory being visited in post-order.
The contents of the
.Fa FTSENT
structure will be unchanged from when
-it was returned in pre-order, i.e. with the
+it was returned in pre-order, that is, with the
.Fa fts_info
field set to
.Dv FTS_D .
@@ -274,7 +274,7 @@ It is initialized to
A pointer to the
.Fa FTSENT
structure referencing the file in the hierarchy
-immediately above the current file, i.e. the directory of which this
+immediately above the current file, that is, the directory of which this
file is a member.
A parent structure for the initial entry point is provided as well,
however, only the
@@ -569,7 +569,7 @@ has not yet been called for a hierarchy,
.Fn fts_children
will return a pointer to the files in the logical directory specified to
.Fn fts_open ,
-i.e. the arguments specified to
+that is, the arguments specified to
.Fn fts_open .
Otherwise, if the
.Fa FTSENT
diff --git a/man3/fwide.3 b/man3/fwide.3
index 65357d8bbc..39a05fd60a 100644
--- a/man3/fwide.3
+++ b/man3/fwide.3
@@ -26,7 +26,7 @@ When \fImode\fP is zero, the
function determines the current
orientation of \fIstream\fP.
It returns a value > 0 if \fIstream\fP is
-wide-character oriented, i.e. if wide-character I/O is permitted but char
+wide-character oriented, that is, if wide-character I/O is permitted but char
I/O is disallowed.
It returns a value < 0 if \fIstream\fP is byte oriented,
i.e. if char I/O is permitted but wide-character I/O is disallowed.
diff --git a/man3/gethostbyname.3 b/man3/gethostbyname.3
index 7e66478d15..7ec96331c0 100644
--- a/man3/gethostbyname.3
+++ b/man3/gethostbyname.3
@@ -310,9 +310,9 @@ line by line.
On many systems a routine of this name reads
from the file
.IR /etc/hosts .
-.\" e.g. Linux, FreeBSD, Unixware, HP-UX
+.\" e.g., Linux, FreeBSD, Unixware, HP-UX
It may be available only when the library was built without DNS support.
-.\" e.g. FreeBSD, AIX
+.\" e.g., FreeBSD, AIX
The glibc version will ignore ipv6 entries.
This function is not reentrant,
and glibc adds a reentrant version
diff --git a/man3/grantpt.3 b/man3/grantpt.3
index b8d5847f4a..2c0049073f 100644
--- a/man3/grantpt.3
+++ b/man3/grantpt.3
@@ -19,7 +19,7 @@ function changes the mode and owner of the slave pseudo-terminal device
(pty) corresponding to the master pty referred to by
.IR fd .
The user ID of the slave is set to the real UID of the calling process.
-The group ID is set to an unspecified value (e.g. tty).
+The group ID is set to an unspecified value (e.g., tty).
The mode of the slave is set to 0620 (crw\-\-w\-\-\-\-).
.PP
The behavior of
diff --git a/man3/iconv.3 b/man3/iconv.3
index 00926607c7..8b15212bc5 100644
--- a/man3/iconv.3
+++ b/man3/iconv.3
@@ -51,8 +51,8 @@ In this case
it sets \fIerrno\fP to \fBEILSEQ\fP and returns (size_t)(\-1). \fI*inbuf\fP
is left pointing to the beginning of the invalid multibyte sequence.
.PP
-2. The input byte sequence has been entirely converted, i.e. \fI*inbytesleft\fP
-has gone down to 0.
+2. The input byte sequence has been entirely converted,
+that is, \fI*inbytesleft\fP has gone down to 0.
In this case
.BR iconv ()
returns the number of
diff --git a/man3/insque.3 b/man3/insque.3
index 221c5a5e9e..e0bf00e8fb 100644
--- a/man3/insque.3
+++ b/man3/insque.3
@@ -58,7 +58,7 @@ doubly-linked list.
.SH "CONFORMING TO"
POSIX.1-2001
.SH "NOTES"
-Traditionally (e.g. SunOS, Linux libc 4,5) the parameters of these
+Traditionally (e.g., SunOS, Linux libc 4,5) the parameters of these
functions were of type \fIstruct qelem *\fP, where the struct
is defined as
diff --git a/man3/isalpha.3 b/man3/isalpha.3
index 96ad3f8cd2..a07514a069 100644
--- a/man3/isalpha.3
+++ b/man3/isalpha.3
@@ -132,7 +132,7 @@ and vertical tab
checks for an uppercase letter.
.TP
.BR isxdigit ()
-checks for a hexadecimal digits, i.e. one of
+checks for a hexadecimal digits, that is, one of
.br
.BR "0 1 2 3 4 5 6 7 8 9 a b c d e f A B C D E F" .
.SH "RETURN VALUE"
diff --git a/man3/posix_memalign.3 b/man3/posix_memalign.3
index 7b26351372..e091dfc282 100644
--- a/man3/posix_memalign.3
+++ b/man3/posix_memalign.3
@@ -132,7 +132,7 @@ Libc4,5 and glibc declare it in <malloc.h> and perhaps also in <stdlib.h>
for glibc, if _XOPEN_SOURCE_EXTENDED is defined, or, equivalently,
_XOPEN_SOURCE is defined to a value not less than 500).
.SH NOTES
-On many systems there are alignment restrictions, e.g. on buffers
+On many systems there are alignment restrictions, for example, on buffers
used for direct block device I/O.
POSIX specifies the
.I "pathconf(path,_PC_REC_XFER_ALIGN)"
@@ -162,7 +162,7 @@ or
.BR free (3)
a pointer gotten from
.BR malloc (3),
-while e.g.
+while, for example,
.BR memalign ()
would call
.BR malloc (3)
diff --git a/man3/printf.3 b/man3/printf.3
index 32bb5a0949..9e9b99dc42 100644
--- a/man3/printf.3
+++ b/man3/printf.3
@@ -825,7 +825,7 @@ The glibc implementation of the functions
.BR snprintf ()
and
.BR vsnprintf ()
-conforms to the C99 standard, i.e., behaves as described above,
+conforms to the C99 standard, that is, behaves as described above,
since glibc version 2.1.
Until glibc 2.0.6 they would return \-1
when the output was truncated.
@@ -886,7 +886,7 @@ but provides a libbsd that contains an
.BR snprintf ()
equivalent to
.BR sprintf (),
-i.e., one that ignores the
+that is, one that ignores the
.I size
argument.
Thus, the use of
diff --git a/man3/recno.3 b/man3/recno.3
index f5bbc42915..2bf38e757c 100644
--- a/man3/recno.3
+++ b/man3/recno.3
@@ -175,7 +175,7 @@ field of the key should be the size of that type.
.PP
Because there can be no meta-data associated with the underlying
recno access method files, any changes made to the default values
-(e.g. fixed record length or byte separator value) must be explicitly
+(e.g., fixed record length or byte separator value) must be explicitly
specified each time the file is opened.
.PP
In the interface specified by
diff --git a/man3/scanf.3 b/man3/scanf.3
index 7658e840e1..b772bb721d 100644
--- a/man3/scanf.3
+++ b/man3/scanf.3
@@ -575,7 +575,7 @@ specifiers defined by ANSI C do not make sense
While they may have a well-defined behavior on Linux, this need not
to be so on other architectures.
Therefore it usually is better to use
-modifiers that are not defined by ANSI C at all, i.e. use
+modifiers that are not defined by ANSI C at all, that is, use
.B q
instead of
.B L
diff --git a/man3/setlocale.3 b/man3/setlocale.3
index e63445f715..9c3e4fda60 100644
--- a/man3/setlocale.3
+++ b/man3/setlocale.3
@@ -170,9 +170,9 @@ Linux (that is, GNU libc) supports the portable locales
In the good old days there used to be support for
the European Latin-1
.B """ISO-8859-1"""
-locale (e.g. in libc-4.5.21 and libc-4.6.27), and the Russian
+locale (e.g., in libc-4.5.21 and libc-4.6.27), and the Russian
.B """KOI-8"""
-(more precisely, "koi-8r") locale (e.g. in libc-4.6.27),
+(more precisely, "koi-8r") locale (e.g., in libc-4.6.27),
so that having an environment variable LC_CTYPE=ISO-8859-1
sufficed to make
.BR isprint (3)
diff --git a/man3/stdarg.3 b/man3/stdarg.3
index 822f8ac96b..f3a15228e2 100644
--- a/man3/stdarg.3
+++ b/man3/stdarg.3
@@ -81,7 +81,7 @@ and must be called first.
.PP
The parameter
.I last
-is the name of the last parameter before the variable argument list, i.e.,
+is the name of the last parameter before the variable argument list, that is,
the last parameter of which the calling function knows the type.
.PP
Because the address of this parameter may be used in the
diff --git a/man3/strfmon.3 b/man3/strfmon.3
index 9c7a4013d6..0aae591dc1 100644
--- a/man3/strfmon.3
+++ b/man3/strfmon.3
@@ -59,7 +59,7 @@ The ( flag indicates that negative amounts should be enclosed between
parentheses.
The + flag indicates that signs should be handled
in the default way, that is, amounts are preceded by the locale's
-sign indication, e.g., nothing for positive, "\-" for negative.
+sign indication, for example, nothing for positive, "\-" for negative.
.TP
.BR !
Omit the currency symbol.
diff --git a/man3/strftime.3 b/man3/strftime.3
index 688b2cc4f8..a77bab4432 100644
--- a/man3/strftime.3
+++ b/man3/strftime.3
@@ -103,7 +103,7 @@ ISO week number belongs to the previous or next year,
that year is used instead. (TZ)
.TP
.B %g
-Like %G, but without century, i.e., with a 2-digit year (00-99). (TZ)
+Like %G, but without century, that is, with a 2-digit year (00-99). (TZ)
.TP
.B %h
Equivalent to %b. (SU)
@@ -155,7 +155,7 @@ The time in 24-hour notation (%H:%M). (SU)
For a version including the seconds, see %T below.
.TP
.B %s
-The number of seconds since the Epoch, i.e., since 1970-01-01
+The number of seconds since the Epoch, that is, since 1970-01-01
00:00:00 UTC. (TZ)
.TP
.B %S
diff --git a/man3/strptime.3 b/man3/strptime.3
index 94995c7f27..3c8276051e 100644
--- a/man3/strptime.3
+++ b/man3/strptime.3
@@ -345,7 +345,7 @@ as a synonym for %I, and %P is accepted as a synonym for %p.
Finally
.TP
.B %s
-The number of seconds since the epoch, i.e., since 1970-01-01 00:00:00 UTC.
+The number of seconds since the epoch, that is, since 1970-01-01 00:00:00 UTC.
Leap seconds are not counted unless leap second support is available.
.LP
The GNU libc implementation does not require whitespace between
diff --git a/man3/termios.3 b/man3/termios.3
index 9a8983d238..2cb1fe96cc 100644
--- a/man3/termios.3
+++ b/man3/termios.3
@@ -249,7 +249,7 @@ and
for getting at it.
Some systems use bits selected by CBAUD in
.IR c_cflag ,
-other systems use separate fields, e.g.
+other systems use separate fields, for example,
.I sg_ispeed
and
.IR sg_ospeed .)
diff --git a/man3/wcpncpy.3 b/man3/wcpncpy.3
index 839b43d295..35acb9d32d 100644
--- a/man3/wcpncpy.3
+++ b/man3/wcpncpy.3
@@ -47,7 +47,7 @@ The programmer must ensure that there is room for at least \fIn\fP wide
characters at \fIdest\fP.
.SH "RETURN VALUE"
.BR wcpncpy ()
-returns a pointer to the last wide character written, i.e.
+returns a pointer to the last wide character written, that is,
\fIdest + n \- 1\fP.
.SH "CONFORMING TO"
This function is a GNU extension.
diff --git a/man3/wcrtomb.3 b/man3/wcrtomb.3
index 4d851aeadf..a2bea2e3f0 100644
--- a/man3/wcrtomb.3
+++ b/man3/wcrtomb.3
@@ -33,7 +33,7 @@ at the beginning of the character
array pointed to by \fIs\fP.
It updates the shift state \fI*ps\fP, and
returns the length of said multibyte representation,
-i.e. the number of bytes
+that is, the number of bytes
written at \fIs\fP.
.PP
A different case is when \fIs\fP is not NULL but \fIwc\fP is L'\\0'.
@@ -45,10 +45,10 @@ the character array pointed to by
\fIs\fP the shift sequence needed to
bring \fI*ps\fP back to the initial state,
followed by a '\\0' byte.
-It updates the shift state \fI*ps\fP (i.e. brings
+It updates the shift state \fI*ps\fP (i.e., brings
it into the initial state),
and returns the length of the shift sequence plus
-one, i.e. the number of bytes written at \fIs\fP.
+one, that is, the number of bytes written at \fIs\fP.
.PP
A third case is when \fIs\fP is NULL.
In this case \fIwc\fP is ignored,
diff --git a/man3/wcstok.3 b/man3/wcstok.3
index d530c0a637..764d8423c4 100644
--- a/man3/wcstok.3
+++ b/man3/wcstok.3
@@ -33,7 +33,7 @@ defined as a substring not containing any wide-characters from \fIdelim\fP.
.PP
The search starts at \fIwcs\fP, if \fIwcs\fP is not NULL,
or at \fI*ptr\fP, if \fIwcs\fP is NULL.
-First, any delimiter wide-characters are skipped, i.e. the
+First, any delimiter wide-characters are skipped, that is, the
pointer is advanced beyond any wide-characters which occur in \fIdelim\fP.
If the end of the wide-character string is now
reached,
diff --git a/man3/wctomb.3 b/man3/wctomb.3
index d23ba049ad..4e99c8862f 100644
--- a/man3/wctomb.3
+++ b/man3/wctomb.3
@@ -31,7 +31,7 @@ It updates the shift state, which
is stored in a static anonymous variable
only known to the wctomb function,
and returns the length of said multibyte representation,
-i.e. the number of
+that is, the number of
bytes written at \fIs\fP.
.PP
The programmer must ensure that there is
diff --git a/man3/wprintf.3 b/man3/wprintf.3
index 49d55b5257..abdbeaf7d6 100644
--- a/man3/wprintf.3
+++ b/man3/wprintf.3
@@ -191,7 +191,7 @@ of the form \\unnnn does not solve this problem.)
Therefore, in
internationalized programs, the \fIformat\fP string should consist of ASCII
wide characters only, or should be constructed at run time in an
-internationalized way (e.g. using
+internationalized way (e.g., using
.BR gettext (3)
or
.BR iconv (3),