diff options
| author | Michael Kerrisk <mtk.manpages@gmail.com> | 2013-03-31 10:53:00 +0200 |
|---|---|---|
| committer | Michael Kerrisk <mtk.manpages@gmail.com> | 2013-04-01 14:53:46 +0200 |
| commit | 33a0ccb2938077c5970488cae9d76a6b6eb85ced (patch) | |
| tree | 75c7046ad4757f8d5f95d6ac0b7230214b0f3573 /man3 | |
| parent | 90878f7c26d108a4bae66b171a45ef27bd7c5f3e (diff) | |
| download | man-pages-33a0ccb2938077c5970488cae9d76a6b6eb85ced.tar.gz | |
intro.1, _syscall.2, access.2, arch_prctl.2, cacheflush.2, chown.2, clock_getres.2, clone.2, create_module.2, fcntl.2, flock.2, get_kernel_syms.2, get_robust_list.2, get_thread_area.2, getcpu.2, getpriority.2, getrlimit.2, getrusage.2, ioprio_set.2, kexec_load.2, madvise.2, mbind.2, migrate_pages.2, mknod.2, mmap.2, mount.2, move_pages.2, mprotect.2, open.2, pause.2, pciconfig_read.2, perf_event_open.2, prctl.2, ptrace.2, query_module.2, read.2, reboot.2, recv.2, s390_runtime_instr.2, sched_setscheduler.2, select_tut.2, send.2, set_mempolicy.2, setfsgid.2, setfsuid.2, sigaction.2, spu_create.2, spu_run.2, stime.2, swapon.2, syslog.2, timer_create.2, timer_getoverrun.2, times.2, tkill.2, umount.2, unimplemented.2, ustat.2, vm86.2, wait.2, abs.3, aio_read.3, aio_write.3, bsd_signal.3, catgets.3, clearenv.3, cmsg.3, dbopen.3, dirfd.3, dlopen.3, exec.3, fenv.3, ferror.3, fmemopen.3, fnmatch.3, fopen.3, futimes.3, getaddrinfo.3, getifaddrs.3, getipnodebyname.3, hsearch.3, if_nameindex.3, inet_pton.3, mblen.3, mbrlen.3, mbsrtowcs.3, mbtowc.3, mcheck.3, memfrob.3, mq_notify.3, netlink.3, posix_memalign.3, printf.3, pthread_attr_setscope.3, pthread_cleanup_push.3, pthread_kill_other_threads_np.3, pthread_self.3, pthread_setcancelstate.3, pthread_setconcurrency.3, raise.3, resolver.3, rpc.3, rtime.3, rtnetlink.3, scanf.3, setbuf.3, setnetgrent.3, shm_open.3, sigpause.3, sigset.3, sigwait.3, sockatmark.3, strcasecmp.3, strcmp.3, strdup.3, strftime.3, strptime.3, strsignal.3, strverscmp.3, sysv_signal.3, termios.3, wcrtomb.3, wcsnlen.3, wcsnrtombs.3, wcsrtombs.3, wctomb.3, wprintf.3, console_codes.4, cpuid.4, msr.4, rtc.4, sk98lin.4, st.4, tty.4, charmap.5, core.5, elf.5, hosts.equiv.5, proc.5, resolv.conf.5, services.5, slabinfo.5, arp.7, bootparam.7, capabilities.7, charsets.7, cpuset.7, ddp.7, epoll.7, feature_test_macros.7, futex.7, hier.7, icmp.7, inotify.7, ip.7, ipv6.7, man-pages.7, mdoc.7, mdoc.samples.7, netdevice.7, netlink.7, numa.7, packet.7, path_resolution.7, posixoptions.7, pthreads.7, raw.7, rtld-audit.7, rtnetlink.7, sem_overview.7, sigevent.7, socket.7, spufs.7, tcp.7, udp.7, unicode.7, uri.7, utf-8.7, intro.8, ldconfig.8, sync.8: Global fix: fix placement of word "only"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Diffstat (limited to 'man3')
67 files changed, 93 insertions, 97 deletions
diff --git a/man3/abs.3 b/man3/abs.3 index 222ecf2428..1abc231513 100644 --- a/man3/abs.3 +++ b/man3/abs.3 @@ -81,7 +81,7 @@ Returns the absolute value of the integer argument, of the appropriate integer type for the function. .SH CONFORMING TO SVr4, POSIX.1-2001, 4.3BSD, C99. -.\" POSIX.1 (1996 edition) only requires the +.\" POSIX.1 (1996 edition) requires only the .\" .BR abs () .\" function. C89 only diff --git a/man3/aio_read.3 b/man3/aio_read.3 index 0c8eb99102..6b8f81c960 100644 --- a/man3/aio_read.3 +++ b/man3/aio_read.3 @@ -91,7 +91,7 @@ On error the request is not enqueued, \-1 is returned, and .I errno is set appropriately. -If an error is only detected later, it will +If an error is detected only later, it will be reported via .BR aio_return (3) (returns status \-1) and diff --git a/man3/aio_write.3 b/man3/aio_write.3 index bf6bc81647..f6e855a0ad 100644 --- a/man3/aio_write.3 +++ b/man3/aio_write.3 @@ -98,7 +98,7 @@ On error the request is not enqueued, \-1 is returned, and .I errno is set appropriately. -If an error is only detected later, it will +If an error is detected only later, it will be reported via .BR aio_return (3) (returns status \-1) and diff --git a/man3/bsd_signal.3 b/man3/bsd_signal.3 index 94fba6973b..c7738b3060 100644 --- a/man3/bsd_signal.3 +++ b/man3/bsd_signal.3 @@ -88,7 +88,7 @@ for details. The use of .I sighandler_t is a GNU extension; -this type is only defined if the +this type is defined only if the .B _GNU_SOURCE feature test macro is defined. .SH SEE ALSO diff --git a/man3/catgets.3 b/man3/catgets.3 index ece3bd8446..059888b989 100644 --- a/man3/catgets.3 +++ b/man3/catgets.3 @@ -69,7 +69,7 @@ returns the value .SH CONFORMING TO POSIX.1-2001. .SH NOTES -These functions are only available in libc.so.4.4.4c and above. +These functions are available only in libc.so.4.4.4c and above. The Jan 1987 X/Open Portability Guide specifies a more subtle error return: .I message diff --git a/man3/clearenv.3 b/man3/clearenv.3 index 7e4d86dd0c..ba727fe468 100644 --- a/man3/clearenv.3 +++ b/man3/clearenv.3 @@ -67,7 +67,7 @@ and but changed its mind and scheduled these functions for some later issue of this standard (cf. B.4.6.1). However, POSIX.1-2001 -only adds +adds only .BR putenv (3), and rejected .BR clearenv (). diff --git a/man3/cmsg.3 b/man3/cmsg.3 index d6b4c63b15..22057c0159 100644 --- a/man3/cmsg.3 +++ b/man3/cmsg.3 @@ -52,8 +52,8 @@ See their manual pages for more information. Ancillary data is a sequence of .I struct cmsghdr structures with appended data. -This sequence should only be accessed -using the macros described in this manual page and never directly. +This sequence should be accessed +using only the macros described in this manual page and never directly. See the specific protocol man pages for the available control message types. The maximum ancillary buffer size allowed per socket can be set using .IR /proc/sys/net/core/optmem_max ; @@ -144,7 +144,7 @@ the IPv6 advanced API described in RFC\ 2292 and the SUSv2. .BR CMSG_ALIGN () is a Linux extension. .SH NOTES -For portability, ancillary data should be accessed only using the macros +For portability, ancillary data should be accessed using only the macros described here. .BR CMSG_ALIGN () is a Linux extension and should be not used in portable programs. diff --git a/man3/dbopen.3 b/man3/dbopen.3 index a3c6187972..88bd7d6163 100644 --- a/man3/dbopen.3 +++ b/man3/dbopen.3 @@ -312,7 +312,7 @@ are available only for the .B DB_RECNO access method because they each imply that the access method is able to create new keys. -This is only true if the keys are ordered and independent, record numbers +This is true only if the keys are ordered and independent, record numbers for example. .IP The default behavior of the diff --git a/man3/dirfd.3 b/man3/dirfd.3 index 857a5fcd67..0fe9410420 100644 --- a/man3/dirfd.3 +++ b/man3/dirfd.3 @@ -58,7 +58,7 @@ returns the file descriptor associated with the directory stream .IR dirp . .LP This descriptor is the one used internally by the directory stream. -As a result, it is only useful for functions which do not depend on +As a result, it is useful only for functions which do not depend on or alter the file position, such as .BR fstat (2) and @@ -89,7 +89,7 @@ This function was a BSD extension, present in 4.3BSD-Reno, not in 4.2BSD. .SH NOTES The prototype for .BR dirfd () -is only available if +is available only if .B _BSD_SOURCE or .B _SVID_SOURCE diff --git a/man3/dlopen.3 b/man3/dlopen.3 index b1f21be3dc..fbd8b8c609 100644 --- a/man3/dlopen.3 +++ b/man3/dlopen.3 @@ -128,7 +128,7 @@ One of the following two values must be included in Perform lazy binding. Only resolve symbols as the code that references them is executed. If the symbol is never referenced, then it is never resolved. -(Lazy binding is only performed for function references; +(Lazy binding is performed only for function references; references to variables are always immediately bound when the library is loaded.) .TP @@ -224,7 +224,7 @@ has been called on it as many times as has succeeded on it. The .BR _init () -routine, if present, is only called once. +routine, if present, is called only once. But a subsequent call with .B RTLD_NOW may force symbol resolution for a library earlier loaded with diff --git a/man3/exec.3 b/man3/exec.3 index 9c6146088c..afdf651730 100644 --- a/man3/exec.3 +++ b/man3/exec.3 @@ -183,7 +183,7 @@ with the path of the file as its first argument. .SH RETURN VALUE The .BR exec () -functions only return if an error has occurred. +functions return only if an error has occurred. The return value is \-1, and .I errno is set to indicate the error. diff --git a/man3/fenv.3 b/man3/fenv.3 index 84425cba5f..be2b202ace 100644 --- a/man3/fenv.3 +++ b/man3/fenv.3 @@ -272,7 +272,7 @@ which represents an environment where every exception raised causes a trap to occur. You can test for this macro using .BR #ifdef . -It is only defined if +It is defined only if .B _GNU_SOURCE is defined. The C99 standard does not define a way to set individual bits in the diff --git a/man3/ferror.3 b/man3/ferror.3 index 505035def3..c78a4eac1a 100644 --- a/man3/ferror.3 +++ b/man3/ferror.3 @@ -73,8 +73,7 @@ The function tests the end-of-file indicator for the stream pointed to by .IR stream , returning nonzero if it is set. -The end-of-file indicator can only be -cleared by the function +The end-of-file indicator can be cleared only by the function .BR clearerr (). .PP The function @@ -82,7 +81,7 @@ The function tests the error indicator for the stream pointed to by .IR stream , returning nonzero if it is set. -The error indicator can only be reset by the +The error indicator can be reset only by the .BR clearerr () function. .PP diff --git a/man3/fmemopen.3 b/man3/fmemopen.3 index ec7b3fa512..50a734c5c8 100644 --- a/man3/fmemopen.3 +++ b/man3/fmemopen.3 @@ -90,7 +90,7 @@ to allow for this. Attempts to write more than .I size bytes to the buffer result in an error. -(By default, such errors will only be visible when the +(By default, such errors will be visible only when the .I stdio buffer is flushed. Disabling buffering with diff --git a/man3/fnmatch.3 b/man3/fnmatch.3 index eeb40342b4..508bec6640 100644 --- a/man3/fnmatch.3 +++ b/man3/fnmatch.3 @@ -80,7 +80,7 @@ matched if it matches an initial segment of .I string which is followed by a slash. This flag is mainly for the internal -use of glibc and is only implemented in certain cases. +use of glibc and is implemented only in certain cases. .TP .B FNM_CASEFOLD If this flag (a GNU extension) is set, the pattern is matched diff --git a/man3/fopen.3 b/man3/fopen.3 index d30ee7140e..c01d8e98e3 100644 --- a/man3/fopen.3 +++ b/man3/fopen.3 @@ -284,7 +284,7 @@ Currently, .\" As at glibc 2.4: use of .BR mmap (2) -is only attempted for a file opened for reading. +is attempted only for a file opened for reading. .TP .B x .\" Since glibc 2.0? diff --git a/man3/futimes.3 b/man3/futimes.3 index b51f309108..b8d7ce3a5b 100644 --- a/man3/futimes.3 +++ b/man3/futimes.3 @@ -92,7 +92,7 @@ is available since glibc 2.6, and is implemented using the system call, which is supported since kernel 2.6.22. .SH CONFORMING TO These functions are not specified in any standard. -Other than Linux, they are only available on the BSDs. +Other than Linux, they are available only on the BSDs. .SH SEE ALSO .BR utime (2), .BR utimensat (2), diff --git a/man3/getaddrinfo.3 b/man3/getaddrinfo.3 index 3a6ee33422..dec5fca59b 100644 --- a/man3/getaddrinfo.3 +++ b/man3/getaddrinfo.3 @@ -378,8 +378,8 @@ includes the flag, then IPv4 addresses are returned in the list pointed to by .I res only if the local system has at least one -IPv4 address configured, and IPv6 addresses are only returned -if the local system has at least one IPv6 address configured. +IPv4 address configured, and IPv6 addresses are returned +only if the local system has at least one IPv6 address configured. The loopback address is not considered for this case as valid as a configured address. .PP @@ -542,7 +542,7 @@ The requested service is not available for the requested socket type. It may be available through another socket type. For example, this error could occur if .I service -was "shell" (a service only available on stream sockets), and either +was "shell" (a service available only on stream sockets), and either .I hints.ai_protocol was .BR IPPROTO_UDP , diff --git a/man3/getifaddrs.3 b/man3/getifaddrs.3 index 1003da6e01..0a67dcb436 100644 --- a/man3/getifaddrs.3 +++ b/man3/getifaddrs.3 @@ -163,9 +163,9 @@ or The .BR getifaddrs () function first appeared in glibc 2.3, but before glibc 2.3.3, -the implementation only supported IPv4 addresses; +the implementation supported only IPv4 addresses; IPv6 support was added in glibc 2.3.3. -Support of address families other than IPv4 is only available +Support of address families other than IPv4 is available only on kernels that support netlink. .SH CONFORMING TO Not in POSIX.1-2001. diff --git a/man3/getipnodebyname.3 b/man3/getipnodebyname.3 index cb615aef8d..9972eaa425 100644 --- a/man3/getipnodebyname.3 +++ b/man3/getipnodebyname.3 @@ -73,7 +73,7 @@ These functions replace the .BR gethostbyname (3) and .BR gethostbyaddr (3) -functions, which could only access the IPv4 network address family. +functions, which could access only the IPv4 network address family. The .BR getipnodebyname () and diff --git a/man3/hsearch.3 b/man3/hsearch.3 index 52e0299959..e66c840a1b 100644 --- a/man3/hsearch.3 +++ b/man3/hsearch.3 @@ -220,7 +220,7 @@ and .I key was not found in the table. .PP -POSIX.1-2001 only specifies the +POSIX.1-2001 specifies only the .B ENOMEM error. .SH CONFORMING TO diff --git a/man3/if_nameindex.3 b/man3/if_nameindex.3 index 8fa9d7aaa3..bb33aa6064 100644 --- a/man3/if_nameindex.3 +++ b/man3/if_nameindex.3 @@ -98,8 +98,8 @@ or The .BR if_nameindex () function first appeared in glibc 2.1, but before glibc 2.3.4, -the implementation only supported interfaces with IPv4 addresses. -Support of interfaces that don't have IPv4 addresses is only available +the implementation supported only interfaces with IPv4 addresses. +Support of interfaces that don't have IPv4 addresses is available only on kernels that support netlink. .SH CONFORMING TO RFC\ 3493, POSIX.1-2001. diff --git a/man3/inet_pton.3 b/man3/inet_pton.3 index cb5a9b4b18..6125de4cc6 100644 --- a/man3/inet_pton.3 +++ b/man3/inet_pton.3 @@ -137,7 +137,7 @@ and supports IPv6 addresses. On the other hand, .BR inet_pton () -only accepts IPv4 addresses in dotted-decimal notation, whereas +accepts only IPv4 addresses in dotted-decimal notation, whereas .BR inet_aton (3) and .BR inet_addr (3) diff --git a/man3/mblen.3 b/man3/mblen.3 index 235df7f418..e176400c4b 100644 --- a/man3/mblen.3 +++ b/man3/mblen.3 @@ -28,8 +28,7 @@ If \fIs\fP is not a NULL pointer, the function inspects at most \fIn\fP bytes of the multibyte string starting at \fIs\fP and extracts the next complete multibyte character. -It uses a static anonymous shift state only -known to the +It uses a static anonymous shift state known only to the .BR mblen () function. If the multibyte character is not the null wide @@ -54,7 +53,7 @@ If \fIs\fP is a NULL pointer, the function .\" The Dinkumware doc and the Single UNIX specification say this, but .\" glibc doesn't implement this. -resets the shift state, only known to this function, to the initial state, and +resets the shift state, known to only this function, to the initial state, and returns nonzero if the encoding has nontrivial shift state, or zero if the encoding is stateless. .SH RETURN VALUE diff --git a/man3/mbrlen.3 b/man3/mbrlen.3 index 469e351b26..da50230697 100644 --- a/man3/mbrlen.3 +++ b/man3/mbrlen.3 @@ -50,7 +50,7 @@ returns In this case, the effects on \fI*ps\fP are undefined. .PP -If \fIps\fP is a NULL pointer, a static anonymous state only known to the +If \fIps\fP is a NULL pointer, a static anonymous state known only to the .BR mbrlen () function is used instead. .SH RETURN VALUE diff --git a/man3/mbsrtowcs.3 b/man3/mbsrtowcs.3 index d0975b8b4b..f1d9974f97 100644 --- a/man3/mbsrtowcs.3 +++ b/man3/mbsrtowcs.3 @@ -67,7 +67,7 @@ and that no length limit exists. .PP In both of the above cases, if \fIps\fP is a NULL pointer, a static anonymous -state only known to the +state known only to the .BR mbsrtowcs () function is used instead. .PP diff --git a/man3/mbtowc.3 b/man3/mbtowc.3 index 9f4784f1dd..26156c5a76 100644 --- a/man3/mbtowc.3 +++ b/man3/mbtowc.3 @@ -32,7 +32,7 @@ bytes of the multibyte string starting at \fIs\fP, extracts the next complete multibyte character, converts it to a wide character and stores it at \fI*pwc\fP. -It updates an internal shift state only known to the +It updates an internal shift state known only to the .BR mbtowc () function. If \fIs\fP does not point to a null byte (\(aq\\0\(aq), it returns the number diff --git a/man3/mcheck.3 b/man3/mcheck.3 index 315e9a614c..17b38cb4e5 100644 --- a/man3/mcheck.3 +++ b/man3/mcheck.3 @@ -72,7 +72,7 @@ This can be very slow! The .BR mcheck_check_all () function causes an immediate check on all allocated blocks. -This call is only effective if +This call is effective only if .BR mcheck () is called beforehand. diff --git a/man3/memfrob.3 b/man3/memfrob.3 index 1dc063892b..732d059e00 100644 --- a/man3/memfrob.3 +++ b/man3/memfrob.3 @@ -49,7 +49,7 @@ on the encrypted memory area. .PP Note that this function is not a proper encryption routine as the XOR -constant is fixed, and is only suitable for hiding strings. +constant is fixed, and is suitable only for hiding strings. .SH RETURN VALUE The .BR memfrob () diff --git a/man3/mq_notify.3 b/man3/mq_notify.3 index ef8ecc57d1..11a711f0dd 100644 --- a/man3/mq_notify.3 +++ b/man3/mq_notify.3 @@ -106,11 +106,11 @@ notifications for this message queue, then the registration is removed; another process can then register to receive a message notification for this queue. -Message notification only occurs when a new message arrives and +Message notification occurs only when a new message arrives and the queue was previously empty. If the queue was not empty at the time .BR mq_notify () -was called, then a notification will only occur after +was called, then a notification will occur only after the queue is emptied and a new message arrives. If another process or thread is waiting to read a message diff --git a/man3/netlink.3 b/man3/netlink.3 index abc1bfac11..734b214e17 100644 --- a/man3/netlink.3 +++ b/man3/netlink.3 @@ -40,7 +40,7 @@ They are similar in spirit to the macros defined in .BR cmsg (3) for auxiliary data. The buffer passed to and from a netlink socket should -only be accessed using these macros. +be accessed using only these macros. .TP .BR NLMSG_ALIGN () Round the length of a netlink message up to align it properly. diff --git a/man3/posix_memalign.3 b/man3/posix_memalign.3 index ed07062417..e00cac4788 100644 --- a/man3/posix_memalign.3 +++ b/man3/posix_memalign.3 @@ -243,9 +243,9 @@ Some systems provide no way to reclaim memory allocated with .BR memalign () or .BR valloc () -(because one can only pass to +(because one can pass to .BR free (3) -a pointer obtained from +only a pointer obtained from .BR malloc (3), while, for example, .BR memalign () @@ -265,8 +265,8 @@ reclaimed with The glibc .BR malloc (3) -always returns 8-byte aligned memory addresses, so these functions are only -needed if you require larger alignment values. +always returns 8-byte aligned memory addresses, so these functions are +needed only if you require larger alignment values. .SH SEE ALSO .BR brk (2), .BR getpagesize (2), diff --git a/man3/printf.3 b/man3/printf.3 index 306c01f305..25986fbe24 100644 --- a/man3/printf.3 +++ b/man3/printf.3 @@ -546,7 +546,7 @@ A following integer conversion corresponds to a .I ptrdiff_t argument. .PP -The SUSv2 only knows about the length modifiers +The SUSv2 knows about only the length modifiers .B h (in .BR hd , diff --git a/man3/pthread_attr_setscope.3 b/man3/pthread_attr_setscope.3 index 523a4baa7d..4d0011eeeb 100644 --- a/man3/pthread_attr_setscope.3 +++ b/man3/pthread_attr_setscope.3 @@ -74,7 +74,7 @@ were created with the .B PTHREAD_SCOPE_SYSTEM contention scope. .PP -POSIX.1-2001 only requires that an implementation support one of these +POSIX.1-2001 requires that an implementation support only one of these contention scopes, but permits both to be supported. Linux supports .BR PTHREAD_SCOPE_SYSTEM , diff --git a/man3/pthread_cleanup_push.3 b/man3/pthread_cleanup_push.3 index 6d7f58fbfb..e0e5c1dcba 100644 --- a/man3/pthread_cleanup_push.3 +++ b/man3/pthread_cleanup_push.3 @@ -94,7 +94,7 @@ containing \(aq\fB{\fP\(aq and \(aq\fB}\fP\(aq, respectively. For this reason, the caller must ensure that calls to these functions are paired within the same function, and at the same lexical nesting level. -(In other words, a clean-up handler is only established +(In other words, a clean-up handler is established only during the execution of a specified section of code.) Calling @@ -132,7 +132,7 @@ and functions \fIare\fP implemented as macros that expand to text containing \(aq\fB{\fP\(aq and \(aq\fB}\fP\(aq, respectively. This means that variables declared within the scope of -paired calls to these functions will only be visible within that scope. +paired calls to these functions will be visible within only that scope. POSIX.1 .\" The text was actually added in the 2004 TC2 diff --git a/man3/pthread_kill_other_threads_np.3 b/man3/pthread_kill_other_threads_np.3 index a4140195c7..0cfde7ec65 100644 --- a/man3/pthread_kill_other_threads_np.3 +++ b/man3/pthread_kill_other_threads_np.3 @@ -34,7 +34,7 @@ pthread_kill_other_threads_np \- terminate all other threads in process .fi .SH DESCRIPTION .BR pthread_kill_other_threads_np () -only has an effect in the LinuxThreads threading implementation. +has an effect only in the LinuxThreads threading implementation. On that implementation, calling this function causes the immediate termination of all threads in the application, diff --git a/man3/pthread_self.3 b/man3/pthread_self.3 index 47008fb103..4c85df708e 100644 --- a/man3/pthread_self.3 +++ b/man3/pthread_self.3 @@ -65,7 +65,7 @@ Thread identifiers should be considered opaque: any attempt to use a thread ID other than in pthreads calls is nonportable and can lead to unspecified results. -Thread IDs are only guaranteed to be unique within a process. +Thread IDs are guaranteed to be unique only within a process. A thread ID may be reused after a terminated thread has been joined, or a detached thread has terminated. diff --git a/man3/pthread_setcancelstate.3 b/man3/pthread_setcancelstate.3 index 82f3fc25a1..da1f634658 100644 --- a/man3/pthread_setcancelstate.3 +++ b/man3/pthread_setcancelstate.3 @@ -143,7 +143,7 @@ if cancellation occurs in the middle of the function call. Consequently, clean-up handlers cease to be useful. Functions that can be safely asynchronously canceled are called .IR "async-cancel-safe functions" . -POSIX.1-2001 only requires that +POSIX.1-2001 requires only that .BR pthread_cancel (3), .BR pthread_setcancelstate (), and diff --git a/man3/pthread_setconcurrency.3 b/man3/pthread_setconcurrency.3 index 059c974ac8..618d2f097f 100644 --- a/man3/pthread_setconcurrency.3 +++ b/man3/pthread_setconcurrency.3 @@ -41,7 +41,7 @@ The function informs the implementation of the application's desired concurrency level, specified in .IR new_level . -The implementation only takes this as a hint: +The implementation takes this only as a hint: POSIX.1 does not specify the level of concurrency that should be provided as a result of calling .BR pthread_setconcurrency (). @@ -85,7 +85,7 @@ POSIX.1-2001. .SH NOTES The default concurrency level is 0. -Concurrency levels are only meaningful for M:N threading implementations, +Concurrency levels are meaningful only for M:N threading implementations, where at any moment a subset of a process's set of user-level threads may be bound to a smaller number of kernel-scheduling entities. Setting the concurrency level allows the application to diff --git a/man3/raise.3 b/man3/raise.3 index ba62ea8df0..851fa0e87c 100644 --- a/man3/raise.3 +++ b/man3/raise.3 @@ -57,7 +57,7 @@ pthread_kill(pthread_self(), sig); .PP If the signal causes a handler to be called, .BR raise () -will only return after the signal handler has returned. +will return only after the signal handler has returned. .SH RETURN VALUE .BR raise () returns 0 on success, and nonzero for failure. diff --git a/man3/resolver.3 b/man3/resolver.3 index 3c4845f64b..e65a225b3c 100644 --- a/man3/resolver.3 +++ b/man3/resolver.3 @@ -188,7 +188,7 @@ has been called. .TP .B RES_DEBUG Print debugging messages. -This option is only available if glibc was built with debugging enabled, +This option is available only if glibc was built with debugging enabled, .\" See resolv/README. .\" Support for RES_DEBUG was made conditional in glibc 2.2. which is not the default. diff --git a/man3/rpc.3 b/man3/rpc.3 index 7a8632e18d..b34be09514 100644 --- a/man3/rpc.3 +++ b/man3/rpc.3 @@ -231,7 +231,7 @@ Default timeouts are set, but can be modified using .BR clnt_control (). .IP Warning: Using UDP has its shortcomings. -Since UDP-based RPC messages can only hold up to 8 Kbytes of encoded data, +Since UDP-based RPC messages can hold only up to 8 Kbytes of encoded data, this transport cannot be used for procedures that take large arguments or return huge results. .LP @@ -477,7 +477,7 @@ time until a response is received or until the call times out. The total time for the call to time out is specified by .BR clnt_call (). .IP -Warning: since UDP-based RPC messages can only hold up to 8 Kbytes +Warning: since UDP-based RPC messages can hold only up to 8 Kbytes of encoded data, this transport cannot be used for procedures that take large arguments or return huge results. .LP @@ -699,7 +699,7 @@ A global variable reflecting the RPC service side's read file descriptor bit mask; it is suitable as a parameter to the .BR select (2) system call. -This is only of interest if a service implementor does not call +This is of interest only if a service implementor does not call .BR svc_run (), but rather does his own asynchronous event processing. This variable is read-only (do not pass its address to @@ -754,7 +754,7 @@ of a procedure associated with the RPC service transport handle, .BI "void svc_getreqset(fd_set *" rdfds ); .fi .IP -This routine is only of interest if a service implementor does not call +This routine is of interest only if a service implementor does not call .BR svc_run (), but instead implements custom asynchronous event processing. It is called when the diff --git a/man3/rtime.3 b/man3/rtime.3 index eaf7675e5f..2ced8166c9 100644 --- a/man3/rtime.3 +++ b/man3/rtime.3 @@ -59,7 +59,7 @@ Only IPv4 is supported. .LP Some .I in.timed -versions only support TCP. +versions support only TCP. Try the example program with .I use_tcp set to 1. diff --git a/man3/rtnetlink.3 b/man3/rtnetlink.3 index ea23a210be..ca6be67bae 100644 --- a/man3/rtnetlink.3 +++ b/man3/rtnetlink.3 @@ -42,8 +42,7 @@ All messages consist of a .BR netlink (7) message header and appended attributes. -The attributes should be only -manipulated using the macros provided here. +The attributes should be manipulated only using the macros provided here. .PP .BI RTA_OK( rta ", " attrlen ) returns true if diff --git a/man3/scanf.3 b/man3/scanf.3 index 62695f3431..e477298ad0 100644 --- a/man3/scanf.3 +++ b/man3/scanf.3 @@ -708,9 +708,9 @@ if (n == 1) { .fi .in .PP -As shown in the above example, it is only necessary to call +As shown in the above example, it is necessary to call .BR free (3) -if the +only if the .BR scanf () call successfully read a string. .SH SEE ALSO diff --git a/man3/setbuf.3 b/man3/setbuf.3 index 87b150400f..ad9914ffb7 100644 --- a/man3/setbuf.3 +++ b/man3/setbuf.3 @@ -124,7 +124,7 @@ only the mode is affected; a new buffer will be allocated on the next read or write operation. The .BR setvbuf () -function may only be used after opening a stream and before any other +function may be used only after opening a stream and before any other operations have been performed on it. .PP The other three calls are, in effect, simply aliases for calls to diff --git a/man3/setnetgrent.3 b/man3/setnetgrent.3 index 9745867282..d6907811eb 100644 --- a/man3/setnetgrent.3 +++ b/man3/setnetgrent.3 @@ -75,7 +75,7 @@ that stores the strings in the supplied buffer. To free all allocated buffers use .BR endnetgrent (). .PP -In most cases you only want to check if the triplet +In most cases you want to check only if the triplet .RI ( hostname ", " username ", " domainname ) is a member of a netgroup. The function diff --git a/man3/shm_open.3 b/man3/shm_open.3 index 67dec98af1..90991a4397 100644 --- a/man3/shm_open.3 +++ b/man3/shm_open.3 @@ -81,9 +81,9 @@ and any of the other flags listed here: .TP 1.1i .B O_RDONLY Open the object for read access. -A shared memory object opened in this way can only be +A shared memory object opened in this way can be .BR mmap (2)ed -for read (\fBPROT_READ\fP) access. +only for read (\fBPROT_READ\fP) access. .TP .B O_RDWR Open the object for read-write access. diff --git a/man3/sigpause.3 b/man3/sigpause.3 index 0da326b7be..2fa352d267 100644 --- a/man3/sigpause.3 +++ b/man3/sigpause.3 @@ -78,7 +78,7 @@ argument (instead of an On Linux, this routine is a system call only on the Sparc (sparc64) architecture. -Libc4 and libc5 only know about the BSD version. +Libc4 and libc5 know only about the BSD version. Glibc uses the BSD version if the .B _BSD_SOURCE diff --git a/man3/sigset.3 b/man3/sigset.3 index 78f36f68ae..5ff17a968d 100644 --- a/man3/sigset.3 +++ b/man3/sigset.3 @@ -192,7 +192,7 @@ These functions appeared in glibc version 2.1. The .I sighandler_t -type is a GNU extension; it is only used on this page to make the +type is a GNU extension; it is used on this page only to make the .BR sigset () prototype more easily readable. diff --git a/man3/sigwait.3 b/man3/sigwait.3 index 8d9ac1d8c9..913b2a28d6 100644 --- a/man3/sigwait.3 +++ b/man3/sigwait.3 @@ -61,7 +61,7 @@ is the same as except that: .IP * 2 .BR sigwait () -only returns the signal number, rather than a +returns only the signal number, rather than a .I siginfo_t structure describing the signal. .IP * diff --git a/man3/sockatmark.3 b/man3/sockatmark.3 index 1945911b5e..ba23d23e5c 100644 --- a/man3/sockatmark.3 +++ b/man3/sockatmark.3 @@ -78,7 +78,7 @@ returns 1, then the out-of-band data can be read using the flag of .BR recv (2). -Out-of-band data is only supported on some stream socket protocols. +Out-of-band data is supported only on some stream socket protocols. .BR sockatmark () can safely be called from a handler for the diff --git a/man3/strcasecmp.3 b/man3/strcasecmp.3 index c404bf1ff3..802981f8e2 100644 --- a/man3/strcasecmp.3 +++ b/man3/strcasecmp.3 @@ -49,8 +49,8 @@ respectively, to be less than, to match, or be greater than \fIs2\fP. .PP The .BR strncasecmp () -function is similar, except it only compares -the first \fIn\fP bytes of \fIs1\fP. +function is similar, except it compares +the only first \fIn\fP bytes of \fIs1\fP. .SH RETURN VALUE The .BR strcasecmp () diff --git a/man3/strcmp.3 b/man3/strcmp.3 index 53c19fff25..24b22c4615 100644 --- a/man3/strcmp.3 +++ b/man3/strcmp.3 @@ -51,8 +51,8 @@ to match, or be greater than \fIs2\fP. .PP The .BR strncmp () -function is similar, except it only compares -the first (at most) \fIn\fP bytes of \fIs1\fP and \fIs2\fP. +function is similar, except it compares +the only first (at most) \fIn\fP bytes of \fIs1\fP and \fIs2\fP. .SH RETURN VALUE The .BR strcmp () diff --git a/man3/strdup.3 b/man3/strdup.3 index 4d27c17a97..67a0f54718 100644 --- a/man3/strdup.3 +++ b/man3/strdup.3 @@ -87,7 +87,7 @@ and can be freed with The .BR strndup () -function is similar, but only copies at most +function is similar, but copies at most \fIn\fP bytes. If \fIs\fP is longer than \fIn\fP, only \fIn\fP bytes are copied, and a terminating null byte (\(aq\\0\(aq) is added. @@ -98,7 +98,7 @@ and are similar, but use .BR alloca (3) to allocate the buffer. -They are only available when using the GNU +They are available only when using the GNU GCC suite, and suffer from the same limitations described in .BR alloca (3). .SH RETURN VALUE diff --git a/man3/strftime.3 b/man3/strftime.3 index 3461c71a8f..fde487d820 100644 --- a/man3/strftime.3 +++ b/man3/strftime.3 @@ -412,7 +412,7 @@ Convert alphabetic characters in result string to upper case. .TP .B # Swap the case of the result string. -(This flag only works with certain conversion specifier characters, +(This flag works only with certain conversion specifier characters, and of these, it is only really useful with .BR %Z .) .PP diff --git a/man3/strptime.3 b/man3/strptime.3 index 9a19e1aba0..c5332a8e31 100644 --- a/man3/strptime.3 +++ b/man3/strptime.3 @@ -292,7 +292,7 @@ SUSv2, POSIX.1-2001. .SH NOTES .LP In principle, this function does not initialize \fItm\fP but -only stores the values specified. +stores only the values specified. This means that \fItm\fP should be initialized before the call. Details differ a bit between different UNIX systems. The glibc implementation does not touch those fields which are not diff --git a/man3/strsignal.3 b/man3/strsignal.3 index 6b4f0c0573..89c0b5a926 100644 --- a/man3/strsignal.3 +++ b/man3/strsignal.3 @@ -62,8 +62,7 @@ The .BR strsignal () function returns a string describing the signal number passed in the argument \fIsig\fP. -The string can only be used -until the next call to +The string can be used only until the next call to .BR strsignal (). .PP The array \fIsys_siglist\fP holds the signal description strings diff --git a/man3/strverscmp.3 b/man3/strverscmp.3 index b99e8fb242..60336ac861 100644 --- a/man3/strverscmp.3 +++ b/man3/strverscmp.3 @@ -54,7 +54,7 @@ Thus, the task of .BR strverscmp () is to compare two strings and find the "right" order, while .BR strcmp (3) -only finds the lexicographic order. +finds only the lexicographic order. This function does not use the locale category .BR LC_COLLATE , diff --git a/man3/sysv_signal.3 b/man3/sysv_signal.3 index 1763cbe790..957b9d5fbc 100644 --- a/man3/sysv_signal.3 +++ b/man3/sysv_signal.3 @@ -80,7 +80,7 @@ for details. The use of .I sighandler_t is a GNU extension; -this type is only defined if +this type is defined only if the .B _GNU_SOURCE feature test macro is defined. diff --git a/man3/termios.3 b/man3/termios.3 index d668a4b908..4f5f3041f6 100644 --- a/man3/termios.3 +++ b/man3/termios.3 @@ -104,7 +104,7 @@ cc_t c_cc[NCCS]; /* special characters */ The values that may be assigned to these fields are described below. In the case of the first four bit-mask fields, the definitions of some of the associated flags that may be set are -only exposed if a specific feature test macro (see +exposed only if a specific feature test macro (see .BR feature_test_macros (7)) is defined, as noted in brackets ("[]"). .PP @@ -759,7 +759,7 @@ the timer is restarted after each further byte is received. returns either when the lesser of the number of bytes requested or MIN byte have been read, or when the inter-byte timeout expires. -Because the timer is only started after the initial byte +Because the timer is started only after the initial byte becomes available, at least one byte will be read. .SS Raw mode .LP diff --git a/man3/wcrtomb.3 b/man3/wcrtomb.3 index 9c955e869c..c82a065fd6 100644 --- a/man3/wcrtomb.3 +++ b/man3/wcrtomb.3 @@ -63,7 +63,7 @@ where is an internal anonymous buffer. .PP In all of the above cases, if \fIps\fP is a NULL pointer, a static anonymous -state only known to the +state known only to the .BR wcrtomb () function is used instead. .SH RETURN VALUE diff --git a/man3/wcsnlen.3 b/man3/wcsnlen.3 index 92f40b78ca..75405a8b5b 100644 --- a/man3/wcsnlen.3 +++ b/man3/wcsnlen.3 @@ -54,7 +54,7 @@ but at most wide characters (note: this parameter is not a byte count). In doing this, .BR wcsnlen () -looks only at the first \fImaxlen\fP +looks at only the first \fImaxlen\fP wide characters at \fIs\fP and never beyond \fIs+maxlen\fP. .SH RETURN VALUE The diff --git a/man3/wcsnrtombs.3 b/man3/wcsnrtombs.3 index 88e59f6a7f..3efeea7bc8 100644 --- a/man3/wcsnrtombs.3 +++ b/man3/wcsnrtombs.3 @@ -99,7 +99,7 @@ no destination length limit exists. .PP In both of the above cases, if \fIps\fP is a NULL pointer, a static anonymous -state only known to the +state known only to the .BR wcsnrtombs () function is used instead. .PP diff --git a/man3/wcsrtombs.3 b/man3/wcsrtombs.3 index 60ab4273fb..f1c2bfc691 100644 --- a/man3/wcsrtombs.3 +++ b/man3/wcsrtombs.3 @@ -74,7 +74,7 @@ no length limit exists. .PP In both of the above cases, if \fIps\fP is a NULL pointer, a static anonymous -state only known to the +state known only to the .BR wcsrtombs () function is used instead. .PP diff --git a/man3/wctomb.3 b/man3/wctomb.3 index 72a07909b2..7ac76ef507 100644 --- a/man3/wctomb.3 +++ b/man3/wctomb.3 @@ -31,7 +31,7 @@ function converts the wide character the character array pointed to by \fIs\fP. It updates the shift state, which is stored in a static anonymous variable -only known to the +known only to the .BR wctomb () function, and returns the length of said multibyte representation, @@ -47,7 +47,7 @@ If \fIs\fP is NULL, the function .\" The Dinkumware doc and the Single UNIX specification say this, but .\" glibc doesn't implement this. -resets the shift state, only known to this function, +resets the shift state, known only to this function, to the initial state, and returns nonzero if the encoding has nontrivial shift state, or zero if the encoding is stateless. diff --git a/man3/wprintf.3 b/man3/wprintf.3 index 8fb9b551f4..6b838d1a7f 100644 --- a/man3/wprintf.3 +++ b/man3/wprintf.3 @@ -204,7 +204,7 @@ category of the current locale. .PP If the \fIformat\fP string contains non-ASCII wide characters, the program -will only work correctly if the +will work correctly only if the .B LC_CTYPE category of the current locale at run time is the same as the |