mirror of https://github.com/mkerrisk/man-pages
getent.1, fanotify_mark.2, fcntl.2, futex.2, membarrier.2, mmap.2, mount.2, msgctl.2, readv.2, semctl.2, set_mempolicy.2, shmctl.2, syscalls.2, abs.3, bstring.3, btree.3, ctime.3, drand48.3, fgetc.3, fopen.3, gethostbyname.3, getnetent.3, getprotoent.3, getservent.3, INFINITY.3, __ppc_set_ppr_med.3, inet.3, j0.3, makecontext.3, printf.3, puts.3, resolver.3, sigsetops.3, elf.5, nscd.conf.5, proc.5, inotify.7, ipv6.7, spufs.7, system_data_types.7: Use Oxford comma
Found using: pcregrep -rnM "^\.[B|I]R .*,\n\.[B|I].*[^,]\nand" man? |grep ^man |sort Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
parent
14d43d3005
commit
d556548bf4
|
@ -209,7 +209,7 @@ Alternatively, three
|
|||
.I keys
|
||||
may be provided, which are interpreted as the
|
||||
.IR hostname ,
|
||||
.I username
|
||||
.IR username ,
|
||||
and
|
||||
.I domainname
|
||||
to match to a netgroup name via
|
||||
|
|
|
@ -511,7 +511,7 @@ If
|
|||
.I flags
|
||||
contains
|
||||
.BR FAN_MARK_FLUSH ,
|
||||
.I dirfd
|
||||
.IR dirfd ,
|
||||
and
|
||||
.I pathname
|
||||
must specify a valid filesystem object, even though this object is not used.
|
||||
|
|
|
@ -700,7 +700,7 @@ asynchronous notification of lost locks.
|
|||
.BR F_SETOWN ,
|
||||
.BR F_GETOWN_EX ,
|
||||
.BR F_SETOWN_EX ,
|
||||
.BR F_GETSIG
|
||||
.BR F_GETSIG ,
|
||||
and
|
||||
.B F_SETSIG
|
||||
are used to manage I/O availability signals:
|
||||
|
|
|
@ -417,7 +417,7 @@ the caller will receive the signal number that was passed in
|
|||
.IP
|
||||
The arguments
|
||||
.IR timeout ,
|
||||
.I uaddr2
|
||||
.IR uaddr2 ,
|
||||
and
|
||||
.I val3
|
||||
are ignored.
|
||||
|
|
|
@ -224,7 +224,7 @@ to represent explicit memory barriers forcing full memory
|
|||
ordering across the barrier, we have the following ordering table for
|
||||
each pairing of
|
||||
.IR barrier() ,
|
||||
.BR membarrier ()
|
||||
.BR membarrier (),
|
||||
and
|
||||
.IR smp_mb() .
|
||||
The pair ordering is detailed as (O: ordered, X: not ordered):
|
||||
|
|
|
@ -843,7 +843,7 @@ to be a multiple of the underlying huge page size.
|
|||
.PP
|
||||
For
|
||||
.BR munmap (),
|
||||
.I addr
|
||||
.IR addr ,
|
||||
and
|
||||
.I length
|
||||
must both be a multiple of the underlying huge page size.
|
||||
|
|
|
@ -288,7 +288,7 @@ Symbolic links can still be created,
|
|||
and
|
||||
.BR readlink (1),
|
||||
.BR readlink (2),
|
||||
.BR realpath (1)
|
||||
.BR realpath (1),
|
||||
and
|
||||
.BR realpath (3)
|
||||
all still work properly.
|
||||
|
|
|
@ -424,7 +424,7 @@ to include these header files.
|
|||
.PP
|
||||
The
|
||||
.BR IPC_INFO ,
|
||||
.B MSG_STAT
|
||||
.BR MSG_STAT ,
|
||||
and
|
||||
.B MSG_INFO
|
||||
operations are used by the
|
||||
|
|
|
@ -267,12 +267,12 @@ argument is \-1, the current file offset is updated.
|
|||
.SH RETURN VALUE
|
||||
On success,
|
||||
.BR readv (),
|
||||
.BR preadv ()
|
||||
.BR preadv (),
|
||||
and
|
||||
.BR preadv2 ()
|
||||
return the number of bytes read;
|
||||
.BR writev (),
|
||||
.BR pwritev ()
|
||||
.BR pwritev (),
|
||||
and
|
||||
.BR pwritev2 ()
|
||||
return the number of bytes written.
|
||||
|
|
|
@ -554,7 +554,7 @@ to include these header files.
|
|||
.PP
|
||||
The
|
||||
.BR IPC_INFO ,
|
||||
.B SEM_STAT
|
||||
.BR SEM_STAT ,
|
||||
and
|
||||
.B SEM_INFO
|
||||
operations are used by the
|
||||
|
|
|
@ -42,7 +42,7 @@ sets the NUMA memory policy of the calling thread,
|
|||
which consists of a policy mode and zero or more nodes,
|
||||
to the values specified by the
|
||||
.IR mode ,
|
||||
.I nodemask
|
||||
.IR nodemask ,
|
||||
and
|
||||
.I maxnode
|
||||
arguments.
|
||||
|
|
|
@ -480,7 +480,7 @@ to include these header files.
|
|||
.PP
|
||||
The
|
||||
.BR IPC_INFO ,
|
||||
.B SHM_STAT
|
||||
.BR SHM_STAT ,
|
||||
and
|
||||
.B SHM_INFO
|
||||
operations are used by the
|
||||
|
|
|
@ -966,7 +966,7 @@ and
|
|||
.I __NR_uname
|
||||
refer to the routines
|
||||
.IR sys_olduname (),
|
||||
.IR sys_uname ()
|
||||
.IR sys_uname (),
|
||||
and
|
||||
.IR sys_newuname ().
|
||||
.IP *
|
||||
|
|
|
@ -66,7 +66,7 @@ The macros
|
|||
.B HUGE_VALL
|
||||
expand to constants of types
|
||||
.IR double ,
|
||||
.I float
|
||||
.IR float ,
|
||||
and
|
||||
.IR "long double" ,
|
||||
respectively,
|
||||
|
|
|
@ -82,7 +82,7 @@ priority is set to medium.
|
|||
.SH VERSIONS
|
||||
The functions
|
||||
.BR __ppc_set_ppr_med (),
|
||||
.BR __ppc_set_ppr_low ()
|
||||
.BR __ppc_set_ppr_low (),
|
||||
and
|
||||
.BR __ppc_set_ppr_med_low ()
|
||||
are provided by glibc since version 2.18.
|
||||
|
|
|
@ -65,7 +65,7 @@ function computes the absolute value of the integer
|
|||
argument \fIj\fP.
|
||||
The
|
||||
.BR labs (),
|
||||
.BR llabs ()
|
||||
.BR llabs (),
|
||||
and
|
||||
.BR imaxabs ()
|
||||
functions compute the absolute value of the argument \fIj\fP of the
|
||||
|
|
|
@ -68,13 +68,13 @@ for descriptions of each function.
|
|||
.SH NOTES
|
||||
The functions
|
||||
.BR bcmp (),
|
||||
.BR bcopy ()
|
||||
.BR bcopy (),
|
||||
and
|
||||
.BR bzero ()
|
||||
are obsolete.
|
||||
Use
|
||||
.BR memcmp (),
|
||||
.BR memcpy ()
|
||||
.BR memcpy (),
|
||||
and
|
||||
.BR memset ()
|
||||
instead.
|
||||
|
|
|
@ -209,7 +209,7 @@ If the file already exists (and the
|
|||
flag is not specified), the
|
||||
values specified for the arguments
|
||||
.IR flags ,
|
||||
.I lorder
|
||||
.IR lorder ,
|
||||
and
|
||||
.I psize
|
||||
are ignored
|
||||
|
|
|
@ -73,7 +73,7 @@ _POSIX_C_SOURCE
|
|||
.SH DESCRIPTION
|
||||
The
|
||||
.BR ctime (),
|
||||
.BR gmtime ()
|
||||
.BR gmtime (),
|
||||
and
|
||||
.BR localtime ()
|
||||
functions all take
|
||||
|
@ -375,14 +375,14 @@ instead.
|
|||
The four functions
|
||||
.BR asctime (),
|
||||
.BR ctime (),
|
||||
.BR gmtime ()
|
||||
.BR gmtime (),
|
||||
and
|
||||
.BR localtime ()
|
||||
return a pointer to static data and hence are not thread-safe.
|
||||
The thread-safe versions,
|
||||
.BR asctime_r (),
|
||||
.BR ctime_r (),
|
||||
.BR gmtime_r ()
|
||||
.BR gmtime_r (),
|
||||
and
|
||||
.BR localtime_r (),
|
||||
are specified by SUSv2.
|
||||
|
|
|
@ -102,7 +102,7 @@ integers uniformly distributed over the interval [\-2^31,\ 2^31).
|
|||
.PP
|
||||
The
|
||||
.BR srand48 (),
|
||||
.BR seed48 ()
|
||||
.BR seed48 (),
|
||||
and
|
||||
.BR lcong48 ()
|
||||
functions are
|
||||
|
@ -113,7 +113,7 @@ or
|
|||
.BR mrand48 ().
|
||||
The functions
|
||||
.BR erand48 (),
|
||||
.BR nrand48 ()
|
||||
.BR nrand48 (),
|
||||
and
|
||||
.BR jrand48 ()
|
||||
do not require
|
||||
|
@ -167,7 +167,7 @@ into the returned value.
|
|||
.PP
|
||||
The functions
|
||||
.BR drand48 (),
|
||||
.BR lrand48 ()
|
||||
.BR lrand48 (),
|
||||
and
|
||||
.BR mrand48 ()
|
||||
store
|
||||
|
@ -176,7 +176,7 @@ the last 48-bit
|
|||
generated in an internal buffer.
|
||||
The functions
|
||||
.BR erand48 (),
|
||||
.BR nrand48 ()
|
||||
.BR nrand48 (),
|
||||
and
|
||||
.BR jrand48 ()
|
||||
require the calling
|
||||
|
@ -219,7 +219,7 @@ The initialization function
|
|||
allows the user to specify
|
||||
initial values for
|
||||
.IR Xi ,
|
||||
.I a
|
||||
.IR a ,
|
||||
and
|
||||
.IR c .
|
||||
Array argument
|
||||
|
|
|
@ -98,7 +98,7 @@ For nonlocking counterparts, see
|
|||
.BR unlocked_stdio (3).
|
||||
.SH RETURN VALUE
|
||||
.BR fgetc (),
|
||||
.BR getc ()
|
||||
.BR getc (),
|
||||
and
|
||||
.BR getchar ()
|
||||
return the character read as an
|
||||
|
|
|
@ -236,7 +236,7 @@ function is to change the file associated with a standard text stream
|
|||
.SH RETURN VALUE
|
||||
Upon successful completion
|
||||
.BR fopen (),
|
||||
.BR fdopen ()
|
||||
.BR fdopen (),
|
||||
and
|
||||
.BR freopen ()
|
||||
return a
|
||||
|
@ -259,7 +259,7 @@ was invalid.
|
|||
.PP
|
||||
The
|
||||
.BR fopen (),
|
||||
.BR fdopen ()
|
||||
.BR fdopen (),
|
||||
and
|
||||
.BR freopen ()
|
||||
functions may also fail and set
|
||||
|
|
|
@ -498,7 +498,7 @@ but permits to specify the address family to which the address must belong.
|
|||
Glibc2 also has reentrant versions
|
||||
.BR gethostent_r (),
|
||||
.BR gethostbyaddr_r (),
|
||||
.BR gethostbyname_r ()
|
||||
.BR gethostbyname_r (),
|
||||
and
|
||||
.BR gethostbyname2_r ().
|
||||
The caller supplies a
|
||||
|
|
|
@ -130,7 +130,7 @@ The network number in host byte order.
|
|||
.SH RETURN VALUE
|
||||
The
|
||||
.BR getnetent (),
|
||||
.BR getnetbyname ()
|
||||
.BR getnetbyname (),
|
||||
and
|
||||
.BR getnetbyaddr ()
|
||||
functions return a pointer to a
|
||||
|
|
|
@ -123,7 +123,7 @@ The protocol number.
|
|||
.SH RETURN VALUE
|
||||
The
|
||||
.BR getprotoent (),
|
||||
.BR getprotobyname ()
|
||||
.BR getprotobyname (),
|
||||
and
|
||||
.BR getprotobynumber ()
|
||||
functions return a pointer to a
|
||||
|
|
|
@ -142,7 +142,7 @@ The name of the protocol to use with this service.
|
|||
.SH RETURN VALUE
|
||||
The
|
||||
.BR getservent (),
|
||||
.BR getservbyname ()
|
||||
.BR getservbyname (),
|
||||
and
|
||||
.BR getservbyport ()
|
||||
functions return a pointer to a
|
||||
|
|
|
@ -204,7 +204,7 @@ host byte order.
|
|||
The structure \fIin_addr\fP as used in
|
||||
.BR inet_ntoa (),
|
||||
.BR inet_makeaddr (),
|
||||
.BR inet_lnaof ()
|
||||
.BR inet_lnaof (),
|
||||
and
|
||||
.BR inet_netof ()
|
||||
is defined in
|
||||
|
|
|
@ -182,7 +182,7 @@ The others are nonstandard functions that also exist on the BSDs.
|
|||
.SH BUGS
|
||||
There are errors of up to 2e\-16 in the values returned by
|
||||
.BR j0 (),
|
||||
.BR j1 ()
|
||||
.BR j1 (),
|
||||
and
|
||||
.BR jn ()
|
||||
for values of
|
||||
|
|
|
@ -41,7 +41,7 @@ In a System V-like environment, one has the type \fIucontext_t\fP defined in
|
|||
and the four functions
|
||||
.BR getcontext (3),
|
||||
.BR setcontext (3),
|
||||
.BR makecontext ()
|
||||
.BR makecontext (),
|
||||
and
|
||||
.BR swapcontext ()
|
||||
that allow user-level context switching
|
||||
|
|
|
@ -101,7 +101,7 @@ write output to the given output
|
|||
.IR stream ;
|
||||
.BR sprintf (),
|
||||
.BR snprintf (),
|
||||
.BR vsprintf ()
|
||||
.BR vsprintf (),
|
||||
and
|
||||
.BR vsnprintf ()
|
||||
write to the character string
|
||||
|
|
|
@ -83,7 +83,7 @@ For nonlocking counterparts, see
|
|||
.BR unlocked_stdio (3).
|
||||
.SH RETURN VALUE
|
||||
.BR fputc (),
|
||||
.BR putc ()
|
||||
.BR putc (),
|
||||
and
|
||||
.BR putchar ()
|
||||
return the character written as an
|
||||
|
|
|
@ -428,7 +428,7 @@ Do not look up unqualified name as a top-level domain (TLD).
|
|||
Default option which implies:
|
||||
.BR RES_RECURSE ,
|
||||
.BR RES_DEFNAMES ,
|
||||
.BR RES_DNSRCH
|
||||
.BR RES_DNSRCH ,
|
||||
and
|
||||
.BR RES_NOIP6DOTINT .
|
||||
.\"
|
||||
|
|
|
@ -95,7 +95,7 @@ or
|
|||
.BR sigfillset ()
|
||||
before being passed to the functions
|
||||
.BR sigaddset (),
|
||||
.BR sigdelset ()
|
||||
.BR sigdelset (),
|
||||
and
|
||||
.BR sigismember ()
|
||||
or the additional glibc functions described below
|
||||
|
|
|
@ -835,7 +835,7 @@ and
|
|||
.BR SHN_HIRESERVE .
|
||||
The initial entry is used in ELF extensions for
|
||||
.IR e_phnum ,
|
||||
.IR e_shnum
|
||||
.IR e_shnum ,
|
||||
and
|
||||
.IR e_shstrndx ;
|
||||
in other cases, each field in the initial entry is set to zero.
|
||||
|
@ -2143,7 +2143,7 @@ The ELF format is an adopted standard.
|
|||
.PP
|
||||
The extensions for
|
||||
.IR e_phnum ,
|
||||
.IR e_shnum
|
||||
.IR e_shnum ,
|
||||
and
|
||||
.IR e_shstrndx
|
||||
respectively are
|
||||
|
|
|
@ -166,7 +166,7 @@ The files are
|
|||
.IR /etc/passwd ,
|
||||
.IR /etc/group ,
|
||||
.IR /etc/hosts ,
|
||||
.I /etc/services
|
||||
.IR /etc/services ,
|
||||
and
|
||||
.IR /etc/netgroup .
|
||||
The default is yes.
|
||||
|
|
|
@ -6068,7 +6068,7 @@ in the idle process.
|
|||
This string identifies the kernel version that is currently running.
|
||||
It includes the contents of
|
||||
.IR /proc/sys/kernel/ostype ,
|
||||
.I /proc/sys/kernel/osrelease
|
||||
.IR /proc/sys/kernel/osrelease ,
|
||||
and
|
||||
.IR /proc/sys/kernel/version .
|
||||
For example:
|
||||
|
|
|
@ -881,7 +881,7 @@ The following program demonstrates the usage of the inotify API.
|
|||
It marks the directories passed as a command-line arguments
|
||||
and waits for events of type
|
||||
.BR IN_OPEN ,
|
||||
.BR IN_CLOSE_NOWRITE
|
||||
.BR IN_CLOSE_NOWRITE ,
|
||||
and
|
||||
.BR IN_CLOSE_WRITE .
|
||||
.PP
|
||||
|
|
|
@ -396,7 +396,7 @@ for that instead.
|
|||
.PP
|
||||
.BR SOL_IP ,
|
||||
.BR SOL_IPV6 ,
|
||||
.B SOL_ICMPV6
|
||||
.BR SOL_ICMPV6 ,
|
||||
and other
|
||||
.B SOL_*
|
||||
socket options are nonportable variants of
|
||||
|
|
|
@ -550,7 +550,7 @@ If no message has been written to these mailboxes, then
|
|||
contents of these files is undefined.
|
||||
The
|
||||
.IR mbox_stat ,
|
||||
.I ibox_stat
|
||||
.IR ibox_stat ,
|
||||
and
|
||||
.I wbox_stat
|
||||
files contain the available message count.
|
||||
|
|
|
@ -1638,7 +1638,7 @@ family of functions
|
|||
is expanded by the macros
|
||||
.BR SCNuPTR,
|
||||
.BR SCNoPTR,
|
||||
.B SCNxPTR
|
||||
.BR SCNxPTR ,
|
||||
and
|
||||
.B SCNXPTR
|
||||
(defined in
|
||||
|
@ -1678,7 +1678,7 @@ The function must declare an object of type
|
|||
which is used by the macros
|
||||
.BR va_start (3),
|
||||
.BR va_arg (3),
|
||||
.BR va_copy (3)
|
||||
.BR va_copy (3),
|
||||
and
|
||||
.BR va_end (3)
|
||||
to traverse the list of arguments.
|
||||
|
|
Loading…
Reference in New Issue