diff options
Diffstat (limited to 'man3')
49 files changed, 167 insertions, 167 deletions
diff --git a/man3/__setfpucw.3 b/man3/__setfpucw.3 index 0b7a4f99cd..64efa658c6 100644 --- a/man3/__setfpucw.3 +++ b/man3/__setfpucw.3 @@ -57,11 +57,11 @@ can be used. Set FPU control word on the i386 architecture to .RS .PD 0 -.IP \(bu 3 +.IP \[bu] 3 extended precision -.IP \(bu +.IP \[bu] rounding to nearest -.IP \(bu +.IP \[bu] exceptions on overflow, zero divide and NaN .PD .RE diff --git a/man3/aio_suspend.3 b/man3/aio_suspend.3 index 2b33ddfa9d..32a08c5107 100644 --- a/man3/aio_suspend.3 +++ b/man3/aio_suspend.3 @@ -22,13 +22,13 @@ Real-time library The .BR aio_suspend () function suspends the calling thread until one of the following occurs: -.IP \(bu 3 +.IP \[bu] 3 One or more of the asynchronous I/O requests in the list .I aiocb_list has completed. -.IP \(bu +.IP \[bu] A signal is delivered. -.IP \(bu +.IP \[bu] .I timeout is not NULL and the specified time interval has passed. (For details of the diff --git a/man3/backtrace.3 b/man3/backtrace.3 index f078bf67a4..c98d3eb1bb 100644 --- a/man3/backtrace.3 +++ b/man3/backtrace.3 @@ -161,17 +161,17 @@ These functions are GNU extensions. These functions make some assumptions about how a function's return address is stored on the stack. Note the following: -.IP \(bu 3 +.IP \[bu] 3 Omission of the frame pointers (as implied by any of .BR gcc (1)'s nonzero optimization levels) may cause these assumptions to be violated. -.IP \(bu +.IP \[bu] Inlined functions do not have stack frames. -.IP \(bu +.IP \[bu] Tail-call optimization causes one stack frame to replace another. -.IP \(bu +.IP \[bu] .BR backtrace () and .BR backtrace_symbols_fd () diff --git a/man3/bzero.3 b/man3/bzero.3 index 5d41dd0417..0d7171bf8a 100644 --- a/man3/bzero.3 +++ b/man3/bzero.3 @@ -102,7 +102,7 @@ are never optimized away by the compiler. The .BR explicit_bzero () function does not solve all problems associated with erasing sensitive data: -.IP \(bu 3 +.IP \[bu] 3 The .BR explicit_bzero () function does @@ -115,7 +115,7 @@ a register and in "scratch" stack areas. The .BR explicit_bzero () function is not aware of these copies, and can't erase them. -.IP \(bu +.IP \[bu] In some circumstances, .BR explicit_bzero () can diff --git a/man3/dlopen.3 b/man3/dlopen.3 index 907a4088a5..5a97e510fd 100644 --- a/man3/dlopen.3 +++ b/man3/dlopen.3 @@ -68,32 +68,32 @@ Otherwise, the dynamic linker searches for the object as follows (see .BR ld.so (8) for further details): -.IP \(bu 3 +.IP \[bu] 3 (ELF only) If the calling object (i.e., the shared library or executable from which .BR dlopen () is called) contains a DT_RPATH tag, and does not contain a DT_RUNPATH tag, then the directories listed in the DT_RPATH tag are searched. -.IP \(bu +.IP \[bu] If, at the time that the program was started, the environment variable .B LD_LIBRARY_PATH was defined to contain a colon-separated list of directories, then these are searched. (As a security measure, this variable is ignored for set-user-ID and set-group-ID programs.) -.IP \(bu +.IP \[bu] (ELF only) If the calling object contains a DT_RUNPATH tag, then the directories listed in that tag are searched. -.IP \(bu +.IP \[bu] The cache file .I /etc/ld.so.cache (maintained by .BR ldconfig (8)) is checked to see whether it contains an entry for .IR filename . -.IP \(bu +.IP \[bu] The directories .I /lib and diff --git a/man3/duplocale.3 b/man3/duplocale.3 index 67e3343b38..a069c827f7 100644 --- a/man3/duplocale.3 +++ b/man3/duplocale.3 @@ -62,11 +62,11 @@ function were added in glibc 2.3. POSIX.1-2008. .SH NOTES Duplicating a locale can serve the following purposes: -.IP \(bu 3 +.IP \[bu] 3 To create a copy of a locale object in which one of more categories are to be modified (using .BR newlocale (3)). -.IP \(bu +.IP \[bu] To obtain a handle for the current locale which can used in other functions that employ a locale handle, such as .BR toupper_l (3). diff --git a/man3/exit.3 b/man3/exit.3 index 2fd463cb79..8853358467 100644 --- a/man3/exit.3 +++ b/man3/exit.3 @@ -130,7 +130,7 @@ After the exit status must be transmitted to the parent process. There are three cases: -.IP \(bu 3 +.IP \[bu] 3 If the parent has set .BR SA_NOCLDWAIT , or has set the @@ -138,10 +138,10 @@ or has set the handler to .BR SIG_IGN , the status is discarded and the child dies immediately. -.IP \(bu +.IP \[bu] If the parent was waiting on the child, it is notified of the exit status and the child dies immediately. -.IP \(bu +.IP \[bu] Otherwise, the child becomes a "zombie" process: most of the process resources are recycled, diff --git a/man3/fopencookie.3 b/man3/fopencookie.3 index ec05fd8407..6c82ce6be2 100644 --- a/man3/fopencookie.3 +++ b/man3/fopencookie.3 @@ -32,10 +32,10 @@ which provides a stream interface to data that is stored in a buffer in memory. .PP In order to create a custom stream the programmer must: -.IP \(bu 3 +.IP \[bu] 3 Implement four "hook" functions that are used internally by the standard I/O library when performing I/O on the stream. -.IP \(bu +.IP \[bu] Define a "cookie" data type, a structure that provides bookkeeping information (e.g., where to store data) used by the aforementioned hook functions. @@ -46,7 +46,7 @@ when passed to .BR fopencookie ()), but automatically supplies the cookie as the first argument when calling the hook functions. -.IP \(bu +.IP \[bu] Call .BR fopencookie () to open a new stream and associate the cookie and hook functions diff --git a/man3/fpathconf.3 b/man3/fpathconf.3 index a28238c01e..ec42d95bbb 100644 --- a/man3/fpathconf.3 +++ b/man3/fpathconf.3 @@ -157,7 +157,7 @@ or must refer to a terminal. .SH RETURN VALUE The return value of these functions is one of the following: -.IP \(bu 3 +.IP \[bu] 3 On error, \-1 is returned and .I errno is set to indicate the error @@ -166,7 +166,7 @@ is set to indicate the error indicating that .I name is invalid). -.IP \(bu +.IP \[bu] If .I name corresponds to a maximum or minimum limit, and that limit is indeterminate, @@ -178,13 +178,13 @@ is not changed. to zero before the call, and then check whether .I errno is nonzero when \-1 is returned.) -.IP \(bu +.IP \[bu] If .I name corresponds to an option, a positive value is returned if the option is supported, and \-1 is returned if the option is not supported. -.IP \(bu +.IP \[bu] Otherwise, the current value of the option or limit is returned. This value will not be more restrictive than diff --git a/man3/ftw.3 b/man3/ftw.3 index d0ad329adc..4c14e14899 100644 --- a/man3/ftw.3 +++ b/man3/ftw.3 @@ -307,7 +307,7 @@ is never called for a directory that would be a descendant of itself. is an older function that offers a subset of the functionality of .BR nftw (). The notable differences are as follows: -.IP \(bu 3 +.IP \[bu] 3 .BR ftw () has no .I flags @@ -317,11 +317,11 @@ It behaves the same as when is called with .I flags specified as zero. -.IP \(bu +.IP \[bu] The callback function, .IR fn (), is not supplied with a fourth argument. -.IP \(bu +.IP \[bu] The range of values that is passed via the .I typeflag argument supplied to diff --git a/man3/getaddrinfo.3 b/man3/getaddrinfo.3 index b63bd78aa7..b98e3616af 100644 --- a/man3/getaddrinfo.3 +++ b/man3/getaddrinfo.3 @@ -330,7 +330,7 @@ official name of the host. The remaining fields of each returned .I addrinfo structure are initialized as follows: -.IP \(bu 3 +.IP \[bu] 3 The .IR ai_family , .IR ai_socktype , @@ -353,7 +353,7 @@ or and .I ai_protocol returns the protocol for the socket. -.IP \(bu +.IP \[bu] A pointer to the socket address is placed in the .I ai_addr field, and the length of the socket address, in bytes, diff --git a/man3/getaddrinfo_a.3 b/man3/getaddrinfo_a.3 index b9f239db3f..f92a1bea1b 100644 --- a/man3/getaddrinfo_a.3 +++ b/man3/getaddrinfo_a.3 @@ -169,13 +169,13 @@ The argument specifies the size of the array .IR list . The call blocks until one of the following occurs: -.IP \(bu 3 +.IP \[bu] 3 One or more of the operations in .I list completes. -.IP \(bu +.IP \[bu] The call is interrupted by a signal that is caught. -.IP \(bu +.IP \[bu] The time interval specified in .I timeout elapses. diff --git a/man3/getenv.3 b/man3/getenv.3 index 0d4c19d239..b9f9ed2c2d 100644 --- a/man3/getenv.3 +++ b/man3/getenv.3 @@ -51,14 +51,14 @@ function is just like except that it returns NULL in cases where "secure execution" is required. Secure execution is required if one of the following conditions was true when the program run by the calling process was loaded: -.IP \(bu 3 +.IP \[bu] 3 the process's effective user ID did not match its real user ID or the process's effective group ID did not match its real group ID (typically this is the result of executing a set-user-ID or set-group-ID program); -.IP \(bu +.IP \[bu] the effective capability bit was set on the executable file; or -.IP \(bu +.IP \[bu] the process has a nonempty permitted capability set. .PP Secure execution may also be required if triggered diff --git a/man3/getopt.3 b/man3/getopt.3 index ef31a697c8..f5d5fa79a8 100644 --- a/man3/getopt.3 +++ b/man3/getopt.3 @@ -175,14 +175,14 @@ can detect two kinds of errors: and (2) a missing option argument (i.e., an option at the end of the command line without an expected argument). Such errors are handled and reported as follows: -.IP \(bu 3 +.IP \[bu] 3 By default, .BR getopt () prints an error message on standard error, places the erroneous option character in .IR optopt , and returns \[aq]?\[aq] as the function result. -.IP \(bu +.IP \[bu] If the caller has set the global variable .I opterr to zero, then @@ -193,7 +193,7 @@ the function return value is \[aq]?\[aq]. (By default, .I opterr has a nonzero value.) -.IP \(bu +.IP \[bu] If the first character (following any optional \[aq]+\[aq] or \[aq]\-\[aq] described above) of \fIoptstring\fP diff --git a/man3/iconv.3 b/man3/iconv.3 index 8525359661..0ee4b0bcb9 100644 --- a/man3/iconv.3 +++ b/man3/iconv.3 @@ -72,21 +72,21 @@ function can also convert a sequence of input bytes to an update to the conversion state without producing any output bytes; such input is called a \fIshift sequence\fP. The conversion can stop for four reasons: -.IP \(bu 3 +.IP \[bu] 3 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 . \fI*inbuf\fP is left pointing to the beginning of the invalid multibyte sequence. -.IP \(bu +.IP \[bu] 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 nonreversible conversions performed during this call. -.IP \(bu +.IP \[bu] An incomplete multibyte sequence is encountered in the input, and the input byte sequence terminates after it. In this case, it sets \fIerrno\fP to @@ -94,7 +94,7 @@ In this case, it sets \fIerrno\fP to .IR (size_t)\ \-1 . \fI*inbuf\fP is left pointing to the beginning of the incomplete multibyte sequence. -.IP \(bu +.IP \[bu] 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 . diff --git a/man3/ilogb.3 b/man3/ilogb.3 index 8228f8fc64..f6e016fd1c 100644 --- a/man3/ilogb.3 +++ b/man3/ilogb.3 @@ -133,13 +133,13 @@ C99, POSIX.1-2001, POSIX.1-2008. .\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6794 Before glibc 2.16, the following bugs existed in the glibc implementation of these functions: -.IP \(bu 3 +.IP \[bu] 3 The domain error case where .I x is 0 or a NaN did not cause .I errno to be set or (on some architectures) raise a floating-point exception. -.IP \(bu +.IP \[bu] The domain error case where .I x is an infinity did not cause diff --git a/man3/inet_net_pton.3 b/man3/inet_net_pton.3 index 6010e3bb70..4eda6e0058 100644 --- a/man3/inet_net_pton.3 +++ b/man3/inet_net_pton.3 @@ -183,34 +183,34 @@ an explicit size value, then that size becomes the return value of Otherwise, the return value, .IR bits , is inferred as follows: -.IP \(bu 3 +.IP \[bu] 3 If the most significant byte of the network number is greater than or equal to 240, then .I bits is 32. -.IP \(bu +.IP \[bu] Otherwise, if the most significant byte of the network number is greater than or equal to 224, then .I bits is 4. -.IP \(bu +.IP \[bu] Otherwise, if the most significant byte of the network number is greater than or equal to 192, then .I bits is 24. -.IP \(bu +.IP \[bu] Otherwise, if the most significant byte of the network number is greater than or equal to 128, then .I bits is 16. -.IP \(bu +.IP \[bu] Otherwise, .I bits is 8. diff --git a/man3/inet_pton.3 b/man3/inet_pton.3 index 0a12b12d95..1169bac280 100644 --- a/man3/inet_pton.3 +++ b/man3/inet_pton.3 @@ -64,14 +64,14 @@ which must be (16) bytes (128 bits) long. The allowed formats for IPv6 addresses follow these rules: .RS -.IP \(bu 3 +.IP \[bu] 3 The preferred format is .IR x:x:x:x:x:x:x:x . This form consists of eight hexadecimal numbers, each of which expresses a 16-bit value (i.e., each .I x can be up to 4 hex digits). -.IP \(bu +.IP \[bu] A series of contiguous zero values in the preferred format can be abbreviated to .IR :: . @@ -84,7 +84,7 @@ can be abbreviated as .IR ::1 . The wildcard address, consisting of all zeros, can be written as .IR :: . -.IP \(bu +.IP \[bu] An alternate format is useful for expressing IPv4-mapped IPv6 addresses. This form is written as .IR x:x:x:x:x:x:d.d.d.d , diff --git a/man3/intro.3 b/man3/intro.3 index d6d91f6bd6..fd2ac01f52 100644 --- a/man3/intro.3 +++ b/man3/intro.3 @@ -80,11 +80,11 @@ see Section 3 of this manual is organized into subsections that reflect the complex structure of the standard C library and its many implementations: -.IP \(bu 3 +.IP \[bu] 3 3const -.IP \(bu +.IP \[bu] 3head -.IP \(bu +.IP \[bu] 3type .PP This difficult history frequently makes it a poor example to follow diff --git a/man3/mallopt.3 b/man3/mallopt.3 index 513904ef8e..f4f31eda30 100644 --- a/man3/mallopt.3 +++ b/man3/mallopt.3 @@ -285,13 +285,13 @@ to modify the program break. (The measurement unit for this parameter is bytes.) This parameter has an effect in the following circumstances: .RS -.IP \(bu 3 +.IP \[bu] 3 When the program break is increased, then .B M_TOP_PAD bytes are added to the .BR sbrk (2) request. -.IP \(bu +.IP \[bu] When the heap is trimmed as a consequence of calling .BR free (3) (see the discussion of diff --git a/man3/mbsnrtowcs.3 b/man3/mbsnrtowcs.3 index 5df6aaeed7..2ec6a0ee0c 100644 --- a/man3/mbsnrtowcs.3 +++ b/man3/mbsnrtowcs.3 @@ -79,7 +79,7 @@ by one and by the number of bytes consumed. The conversion can stop for three reasons: -.IP \(bu 3 +.IP \[bu] 3 An invalid multibyte sequence has been encountered. In this case, .I *src @@ -90,7 +90,7 @@ and .I errno is set to .BR EILSEQ . -.IP \(bu +.IP \[bu] The .I nms limit forces a stop, @@ -106,7 +106,7 @@ next multibyte sequence to be converted, and the number of wide characters written to .I dest is returned. -.IP \(bu +.IP \[bu] The multibyte string has been completely converted, including the terminating null wide character (\[aq]\e0\[aq]) (which has the side effect of bringing back diff --git a/man3/mbsrtowcs.3 b/man3/mbsrtowcs.3 index e29ea35fbb..fc52d661df 100644 --- a/man3/mbsrtowcs.3 +++ b/man3/mbsrtowcs.3 @@ -51,7 +51,7 @@ by one and .I *src by the number of bytes consumed. The conversion can stop for three reasons: -.IP \(bu 3 +.IP \[bu] 3 An invalid multibyte sequence has been encountered. In this case, .I *src @@ -62,7 +62,7 @@ and .I errno is set to .BR EILSEQ . -.IP \(bu +.IP \[bu] .I len non-L\[aq]\e0\[aq] wide characters have been stored at .IR dest . @@ -73,7 +73,7 @@ multibyte sequence to be converted, and the number of wide characters written to .I dest is returned. -.IP \(bu +.IP \[bu] The multibyte string has been completely converted, including the terminating null wide character (\[aq]\e0\[aq]), which has the side effect of bringing back diff --git a/man3/mbstowcs.3 b/man3/mbstowcs.3 index 166af33bc5..376006fcac 100644 --- a/man3/mbstowcs.3 +++ b/man3/mbstowcs.3 @@ -43,12 +43,12 @@ The sequence of characters in the string .I src shall begin in the initial shift state. The conversion can stop for three reasons: -.IP \(bu 3 +.IP \[bu] 3 An invalid multibyte sequence has been encountered. In this case, .I (size_t)\ \-1 is returned. -.IP \(bu +.IP \[bu] .I n non-L\[aq]\e0\[aq] wide characters have been stored at .IR dest . @@ -56,7 +56,7 @@ In this case, the number of wide characters written to .I dest is returned, but the shift state at this point is lost. -.IP \(bu +.IP \[bu] The multibyte string has been completely converted, including the terminating null character (\[aq]\e0\[aq]). In this case, the number of wide characters written to diff --git a/man3/newlocale.3 b/man3/newlocale.3 index 70dbc75281..3ba72a77d6 100644 --- a/man3/newlocale.3 +++ b/man3/newlocale.3 @@ -38,13 +38,13 @@ returning a reference to the new or modified object as the function result. Whether the call creates a new object or modifies an existing object is determined by the value of .IR base : -.IP \(bu 3 +.IP \[bu] 3 If .I base is .IR "(locale_t)\ 0" , a new object is created. -.IP \(bu +.IP \[bu] If .I base refers to valid existing locale object diff --git a/man3/posix_fallocate.3 b/man3/posix_fallocate.3 index ea0933bd5b..b0d7ce5ae7 100644 --- a/man3/posix_fallocate.3 +++ b/man3/posix_fallocate.3 @@ -147,16 +147,16 @@ system call, which is MT-safe. If the underlying filesystem does not support .BR fallocate (2), then the operation is emulated with the following caveats: -.IP \(bu 3 +.IP \[bu] 3 The emulation is inefficient. -.IP \(bu +.IP \[bu] There is a race condition where concurrent writes from another thread or process could be overwritten with null bytes. -.IP \(bu +.IP \[bu] There is a race condition where concurrent file size increases by another thread or process could result in a file whose size is smaller than expected. -.IP \(bu +.IP \[bu] If .I fd has been opened with the diff --git a/man3/posix_spawn.3 b/man3/posix_spawn.3 index 7509f2fce6..1a6daaf824 100644 --- a/man3/posix_spawn.3 +++ b/man3/posix_spawn.3 @@ -168,7 +168,7 @@ Before glibc 2.24, the child process is created using instead of .BR fork (2) when either of the following is true: -.IP \(bu 3 +.IP \[bu] 3 the .I spawn-flags element of the attributes object pointed to by @@ -176,7 +176,7 @@ element of the attributes object pointed to by contains the GNU-specific flag .BR POSIX_SPAWN_USEVFORK ; or -.IP \(bu +.IP \[bu] .I file_actions is NULL and the .I spawn-flags @@ -306,7 +306,7 @@ of the object pointed to by Set the scheduling policy algorithm and parameters of the child, as follows: .RS -.IP \(bu 3 +.IP \[bu] 3 The scheduling policy is set to the value specified in the .I spawn-schedpolicy attribute @@ -315,7 +315,7 @@ attribute .\" .BR posix_spawnattr_setpolicy (3)) of the object pointed to by .IR attrp . -.IP \(bu +.IP \[bu] The scheduling parameters are set to the value specified in the .I spawn-schedparam attribute diff --git a/man3/psignal.3 b/man3/psignal.3 index 067b1d7f6e..08229ed699 100644 --- a/man3/psignal.3 +++ b/man3/psignal.3 @@ -103,11 +103,11 @@ POSIX.1-2008, 4.3BSD. Up to glibc 2.12, .BR psiginfo () had the following bugs: -.IP \(bu 3 +.IP \[bu] 3 In some circumstances, a trailing newline is not printed. .\" FIXME . http://sourceware.org/bugzilla/show_bug.cgi?id=12107 .\" Reportedly now fixed; check glibc 2.13 -.IP \(bu +.IP \[bu] Additional details are not displayed for real-time signals. .\" FIXME . http://sourceware.org/bugzilla/show_bug.cgi?id=12108 .\" Reportedly now fixed; check glibc 2.13 diff --git a/man3/pthread_atfork.3 b/man3/pthread_atfork.3 index 71e2ea48e4..1875bbdb4a 100644 --- a/man3/pthread_atfork.3 +++ b/man3/pthread_atfork.3 @@ -25,17 +25,17 @@ The handlers are executed in the context of the thread that calls .BR fork (2). .PP Three kinds of handler can be registered: -.IP \(bu 3 +.IP \[bu] 3 .I prepare specifies a handler that is executed in the parent process before .BR fork (2) processing starts. -.IP \(bu +.IP \[bu] .I parent specifies a handler that is executed in the parent process after .BR fork (2) processing completes. -.IP \(bu +.IP \[bu] .I child specifies a handler that is executed in the child process after .BR fork (2) diff --git a/man3/pthread_attr_setsigmask_np.3 b/man3/pthread_attr_setsigmask_np.3 index 07c13adac5..ff9b0355ba 100644 --- a/man3/pthread_attr_setsigmask_np.3 +++ b/man3/pthread_attr_setsigmask_np.3 @@ -108,18 +108,18 @@ that can be used to manipulate and inspect signal sets, see In the absence of .BR pthread_attr_setsigmask_np () it is possible to create a thread with a desired signal mask as follows: -.IP \(bu 3 +.IP \[bu] 3 The creating thread uses .BR pthread_sigmask (3) to save its current signal mask and set its mask to block all signals. -.IP \(bu +.IP \[bu] The new thread is then created using .BR pthread_create (); the new thread will inherit the creating thread's signal mask. -.IP \(bu +.IP \[bu] The new thread sets its signal mask to the desired value using .BR pthread_sigmask (3). -.IP \(bu +.IP \[bu] The creating thread restores its signal mask to the original value. .PP Following the above steps, diff --git a/man3/pthread_cleanup_push.3 b/man3/pthread_cleanup_push.3 index adfbce911f..e76bcf282a 100644 --- a/man3/pthread_cleanup_push.3 +++ b/man3/pthread_cleanup_push.3 @@ -47,11 +47,11 @@ is nonzero. .PP A cancelation clean-up handler is popped from the stack and executed in the following circumstances: -.IP \(bu 3 +.IP \[bu] 3 When a thread is canceled, all of the stacked clean-up handlers are popped and executed in the reverse of the order in which they were pushed onto the stack. -.IP \(bu +.IP \[bu] When a thread terminates by calling .BR pthread_exit (3), all clean-up handlers are executed as described in the preceding point. @@ -61,7 +61,7 @@ called if the thread terminates by performing a .I return from the thread start function.) -.IP \(bu +.IP \[bu] When a thread calls .BR pthread_cleanup_pop () with a nonzero diff --git a/man3/pthread_create.3 b/man3/pthread_create.3 index 4fa3965f1f..5c872641de 100644 --- a/man3/pthread_create.3 +++ b/man3/pthread_create.3 @@ -30,13 +30,13 @@ is passed as the sole argument of .IR start_routine (). .PP The new thread terminates in one of the following ways: -.IP \(bu 3 +.IP \[bu] 3 It calls .BR pthread_exit (3), specifying an exit status value that is available to another thread in the same process that calls .BR pthread_join (3). -.IP \(bu +.IP \[bu] It returns from .IR start_routine (). This is equivalent to calling @@ -44,10 +44,10 @@ This is equivalent to calling with the value supplied in the .I return statement. -.IP \(bu +.IP \[bu] It is canceled (see .BR pthread_cancel (3)). -.IP \(bu +.IP \[bu] Any of the threads in the process calls .BR exit (3), or the main thread performs a return from diff --git a/man3/pthread_getattr_default_np.3 b/man3/pthread_getattr_default_np.3 index 29c795f831..27f9a618f7 100644 --- a/man3/pthread_getattr_default_np.3 +++ b/man3/pthread_getattr_default_np.3 @@ -29,13 +29,13 @@ The default attributes are set using the attributes supplied in .IR *attr , a previously initialized thread attributes object. Note the following details about the supplied attributes object: -.IP \(bu 3 +.IP \[bu] 3 The attribute settings in the object must be valid. -.IP \(bu +.IP \[bu] The .I stack address attribute must not be set in the object. -.IP \(bu +.IP \[bu] Setting the .I stack size attribute to zero means leave the default stack size unchanged. diff --git a/man3/pthread_getattr_np.3 b/man3/pthread_getattr_np.3 index dc3b590a8f..a1c1b9e7ef 100644 --- a/man3/pthread_getattr_np.3 +++ b/man3/pthread_getattr_np.3 @@ -31,13 +31,13 @@ the corresponding attribute values passed in the object that was used to create the thread using .BR pthread_create (3). In particular, the following attributes may differ: -.IP \(bu 3 +.IP \[bu] 3 the detach state, since a joinable thread may have detached itself after creation; -.IP \(bu +.IP \[bu] the stack size, which the implementation may align to a suitable boundary. -.IP \(bu +.IP \[bu] and the guard size, which the implementation may round upward to a multiple of the page size, or ignore (i.e., treat as 0), diff --git a/man3/readdir_r.3 b/man3/readdir_r.3 index 31eab85477..cb4cea710a 100644 --- a/man3/readdir_r.3 +++ b/man3/readdir_r.3 @@ -60,14 +60,14 @@ instead of Furthermore, since glibc 2.24, glibc deprecates .BR readdir_r (). The reasons are as follows: -.IP \(bu 3 +.IP \[bu] 3 On systems where .B NAME_MAX is undefined, calling .BR readdir_r () may be unsafe because the interface does not allow the caller to specify the length of the buffer used for the returned directory entry. -.IP \(bu +.IP \[bu] On some systems, .BR readdir_r () can't read directory entries with very long names. @@ -81,7 +81,7 @@ On some other systems, may return a success status, but the returned .I d_name field may not be null terminated or may be truncated. -.IP \(bu +.IP \[bu] In the current POSIX.1 specification (POSIX.1-2008), .BR readdir (3) is not required to be thread-safe. @@ -98,7 +98,7 @@ using with external synchronization is still preferable to the use of .BR readdir_r (), for the reasons given in the points above. -.IP \(bu +.IP \[bu] It is expected that a future version of POSIX.1 .\" FIXME . .\" http://www.austingroupbugs.net/view.php?id=696 diff --git a/man3/setjmp.3 b/man3/setjmp.3 index 8842b93957..c66a425037 100644 --- a/man3/setjmp.3 +++ b/man3/setjmp.3 @@ -212,17 +212,17 @@ Consequently, the values of automatic variables are unspecified after a call to .BR longjmp () if they meet all the following criteria: -.IP \(bu 3 +.IP \[bu] 3 they are local to the function that made the corresponding .BR setjmp () call; -.IP \(bu +.IP \[bu] their values are changed between the calls to .BR setjmp () and .BR longjmp (); and -.IP \(bu +.IP \[bu] they are not declared as .IR volatile . .PP @@ -302,12 +302,12 @@ that occur upon a return from the initial call to the behavior is undefined if the program subsequently makes a call to a non-async-signal-safe function. The only way of avoiding undefined behavior is to ensure one of the following: -.IP \(bu 3 +.IP \[bu] 3 After long jumping from the signal handler, the program does not call any non-async-signal-safe functions and does not return from the initial call to .IR main (). -.IP \(bu +.IP \[bu] Any signal whose handler performs a long jump must be blocked during .I every call to a non-async-signal-safe function and diff --git a/man3/setlocale.3 b/man3/setlocale.3 index 43b649840a..314dfa0f4a 100644 --- a/man3/setlocale.3 +++ b/man3/setlocale.3 @@ -153,20 +153,20 @@ setlocale(LC_ALL, ""); .in .PP after program initialization, and then: -.IP \(bu 3 +.IP \[bu] 3 using the values returned from a .BR localeconv (3) call for locale-dependent information; -.IP \(bu +.IP \[bu] using the multibyte and wide character functions for text processing if .BR "MB_CUR_MAX > 1" ; -.IP \(bu +.IP \[bu] using .BR strcoll (3) and .BR strxfrm (3) to compare strings; and -.IP \(bu +.IP \[bu] using .BR wcscoll (3) and diff --git a/man3/sigpause.3 b/man3/sigpause.3 index af752cb655..78b0608b23 100644 --- a/man3/sigpause.3 +++ b/man3/sigpause.3 @@ -102,11 +102,11 @@ or is defined. Otherwise, the System V version is used, and feature test macros must be defined as follows to obtain the declaration: -.IP \(bu 3 +.IP \[bu] 3 Since glibc 2.26: _XOPEN_SOURCE >= 500 .\" || (_XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED) -.IP \(bu +.IP \[bu] glibc 2.25 and earlier: _XOPEN_SOURCE .PP Since glibc 2.19, only the System V version is exposed by diff --git a/man3/sigwait.3 b/man3/sigwait.3 index 1015b75b9c..321a182fec 100644 --- a/man3/sigwait.3 +++ b/man3/sigwait.3 @@ -46,12 +46,12 @@ The operation of is the same as .BR sigwaitinfo (2), except that: -.IP \(bu 3 +.IP \[bu] 3 .BR sigwait () returns only the signal number, rather than a .I siginfo_t structure describing the signal. -.IP \(bu +.IP \[bu] The return values of the two functions are different. .SH RETURN VALUE On success, diff --git a/man3/sscanf.3 b/man3/sscanf.3 index 4a13b9dd2a..5813e26721 100644 --- a/man3/sscanf.3 +++ b/man3/sscanf.3 @@ -105,17 +105,17 @@ meaning that the input was inappropriate (see below). .PP A directive is one of the following: .TP -\(bu +\[bu] A sequence of white-space characters (space, tab, newline, etc.; see .BR isspace (3)). This directive matches any amount of white space, including none, in the input. .TP -\(bu +\[bu] An ordinary character (i.e., one other than white space or \[aq]%\[aq]). This character must exactly match the next character of input. .TP -\(bu +\[bu] A conversion specification, which commences with a \[aq]%\[aq] (percent) character. A sequence of characters from the input is converted according to @@ -134,7 +134,7 @@ begins with either the character \[aq]%\[aq] or the character sequence "\fB%\fP\fIn\fP\fB$\fP" (see below for the distinction) followed by: .TP -\(bu +\[bu] An optional \[aq]*\[aq] assignment-suppression character: .BR sscanf () reads input as directed by the conversion specification, @@ -145,7 +145,7 @@ argument is required, and this specification is not included in the count of successful assignments returned by .BR scanf (). .TP -\(bu +\[bu] For decimal conversions, an optional quote character (\[aq]). This specifies that the input number may include thousands' separators as defined by the @@ -156,7 +156,7 @@ category of the current locale. The quote character may precede or follow the \[aq]*\[aq] assignment-suppression character. .TP -\(bu +\[bu] An optional \[aq]m\[aq] character. This is used with string conversions .RI ( %s , @@ -175,7 +175,7 @@ The caller should subsequently .BR free (3) this buffer when it is no longer required. .TP -\(bu +\[bu] An optional decimal integer which specifies the .IR "maximum field width" . Reading of characters stops either when this maximum is reached or @@ -187,7 +187,7 @@ String input conversions store a terminating null byte (\[aq]\e0\[aq]) to mark the end of the input; the maximum field width does not include this terminator. .TP -\(bu +\[bu] An optional .IR "type modifier character" . For example, the @@ -201,7 +201,7 @@ argument refers to a rather than a pointer to an .IR int . .TP -\(bu +\[bu] A .I "conversion specifier" that specifies the type of input conversion to be performed. @@ -641,12 +641,12 @@ As well as being standardized by POSIX, the modifier has the following further advantages over the use of .BR a : -.IP \(bu 3 +.IP \[bu] 3 It may also be applied to .B %c conversion specifiers (e.g., .BR %3mc ). -.IP \(bu +.IP \[bu] It avoids ambiguity with respect to the .B %a floating-point conversion specifier (and is unaffected by diff --git a/man3/strcmp.3 b/man3/strcmp.3 index 5a48a745f9..8a2ee35f99 100644 --- a/man3/strcmp.3 +++ b/man3/strcmp.3 @@ -37,18 +37,18 @@ The comparison is done using unsigned characters. .PP .BR strcmp () returns an integer indicating the result of the comparison, as follows: -.IP \(bu 3 +.IP \[bu] 3 0, if the .I s1 and .I s2 are equal; -.IP \(bu +.IP \[bu] a negative value if .I s1 is less than .IR s2 ; -.IP \(bu +.IP \[bu] a positive value if .I s1 is greater than diff --git a/man3/strsep.3 b/man3/strsep.3 index 0a3bc635db..794ddbec5b 100644 --- a/man3/strsep.3 +++ b/man3/strsep.3 @@ -96,11 +96,11 @@ conforms to C99 and hence is more portable. .SH BUGS Be cautious when using this function. If you do use it, note that: -.IP \(bu 3 +.IP \[bu] 3 This function modifies its first argument. -.IP \(bu +.IP \[bu] This function cannot be used on constant strings. -.IP \(bu +.IP \[bu] The identity of the delimiting character is lost. .SH EXAMPLES The program below is a port of the one found in diff --git a/man3/strtok.3 b/man3/strtok.3 index 4b184f8065..9c80c28235 100644 --- a/man3/strtok.3 +++ b/man3/strtok.3 @@ -189,13 +189,13 @@ that is being used to parse .SH BUGS Be cautious when using these functions. If you do use them, note that: -.IP \(bu 3 +.IP \[bu] 3 These functions modify their first argument. -.IP \(bu +.IP \[bu] These functions cannot be used on constant strings. -.IP \(bu +.IP \[bu] The identity of the delimiting byte is lost. -.IP \(bu +.IP \[bu] The .BR strtok () function uses a static buffer while parsing, so it's not thread safe. diff --git a/man3/sysconf.3 b/man3/sysconf.3 index dd22275eaa..2650cfa860 100644 --- a/man3/sysconf.3 +++ b/man3/sysconf.3 @@ -311,7 +311,7 @@ See also The return value of .BR sysconf () is one of the following: -.IP \(bu 3 +.IP \[bu] 3 On error, \-1 is returned and .I errno is set to indicate the error @@ -320,7 +320,7 @@ is set to indicate the error indicating that .I name is invalid). -.IP \(bu +.IP \[bu] If .I name corresponds to a maximum or minimum limit, and that limit is indeterminate, @@ -332,13 +332,13 @@ is not changed. to zero before the call, and then check whether .I errno is nonzero when \-1 is returned.) -.IP \(bu +.IP \[bu] If .I name corresponds to an option, a positive value is returned if the option is supported, and \-1 is returned if the option is not supported. -.IP \(bu +.IP \[bu] Otherwise, the current value of the option or limit is returned. This value will not be more restrictive than diff --git a/man3/system.3 b/man3/system.3 index ecd30fbb77..414968fd74 100644 --- a/man3/system.3 +++ b/man3/system.3 @@ -62,23 +62,23 @@ returns a status indicating whether a shell is available on the system. The return value of .BR system () is one of the following: -.IP \(bu 3 +.IP \[bu] 3 If .I command is NULL, then a nonzero value if a shell is available, or 0 if no shell is available. -.IP \(bu +.IP \[bu] If a child process could not be created, or its status could not be retrieved, the return value is \-1 and .I errno is set to indicate the error. -.IP \(bu +.IP \[bu] If a shell could not be executed in the child process, then the return value is as though the child shell terminated by calling .BR _exit (2) with the status 127. -.IP \(bu +.IP \[bu] If all system calls succeed, then the return value is the termination status of the child shell used to execute diff --git a/man3/termios.3 b/man3/termios.3 index cb983d190d..2d7fc69a51 100644 --- a/man3/termios.3 +++ b/man3/termios.3 @@ -702,14 +702,14 @@ By default, is set. .PP In canonical mode: -.IP \(bu 3 +.IP \[bu] 3 Input is made available line by line. An input line is available when one of the line delimiters is typed (NL, EOL, EOL2; or EOF at the start of line). Except in the case of EOF, the line delimiter is included in the buffer returned by .BR read (2). -.IP \(bu +.IP \[bu] Line editing is enabled (ERASE, KILL; and if the .B IEXTEN @@ -722,7 +722,7 @@ requested fewer bytes than are available in the current line of input, then only as many bytes as requested are read, and the remaining characters will be available for a future .BR read (2). -.IP \(bu +.IP \[bu] The maximum line length is 4096 chars (including the terminating newline character); lines longer than 4096 chars are truncated. @@ -786,11 +786,11 @@ the timer is restarted after each further byte is received. .BR read (2) returns when any of the following conditions is met: .RS -.IP \(bu 3 +.IP \[bu] 3 MIN bytes have been received. -.IP \(bu +.IP \[bu] The interbyte timer expires. -.IP \(bu +.IP \[bu] The number of bytes requested by .BR read (2) has been received. diff --git a/man3/wcsnrtombs.3 b/man3/wcsnrtombs.3 index 3752f8a926..2b9d387817 100644 --- a/man3/wcsnrtombs.3 +++ b/man3/wcsnrtombs.3 @@ -79,7 +79,7 @@ number of bytes written and .I *src by one. The conversion can stop for three reasons: -.IP \(bu 3 +.IP \[bu] 3 A wide character has been encountered that can not be represented as a multibyte sequence (according to the current locale). In this case, @@ -91,7 +91,7 @@ and .I errno is set to .BR EILSEQ . -.IP \(bu +.IP \[bu] .I nwc wide characters have been converted without encountering a null wide character (L\[aq]\e0\[aq]), @@ -103,7 +103,7 @@ to the next wide character to be converted, and the number of bytes written to .I dest is returned. -.IP \(bu +.IP \[bu] The wide-character string has been completely converted, including the terminating null wide character (which has the side effect of bringing back .I *ps diff --git a/man3/wcsrtombs.3 b/man3/wcsrtombs.3 index 0bc8b753cd..5503b99c5e 100644 --- a/man3/wcsrtombs.3 +++ b/man3/wcsrtombs.3 @@ -52,7 +52,7 @@ number of bytes written and .I *src by one. The conversion can stop for three reasons: -.IP \(bu 3 +.IP \[bu] 3 A wide character has been encountered that can not be represented as a multibyte sequence (according to the current locale). In this case, @@ -64,7 +64,7 @@ and .I errno is set to .BR EILSEQ . -.IP \(bu +.IP \[bu] The length limit forces a stop. In this case, .I *src @@ -73,7 +73,7 @@ to the next wide character to be converted, and the number of bytes written to .I dest is returned. -.IP \(bu +.IP \[bu] The wide-character string has been completely converted, including the terminating null wide character (L\[aq]\e0\[aq]), which has the side effect of bringing back diff --git a/man3/wcstombs.3 b/man3/wcstombs.3 index 1428623743..f13218d97d 100644 --- a/man3/wcstombs.3 +++ b/man3/wcstombs.3 @@ -41,18 +41,18 @@ The sequence of characters placed in .I dest begins in the initial shift state. The conversion can stop for three reasons: -.IP \(bu 3 +.IP \[bu] 3 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 is returned. -.IP \(bu +.IP \[bu] The length limit forces a stop. In this case, the number of bytes written to .I dest is returned, but the shift state at this point is lost. -.IP \(bu +.IP \[bu] The wide-character string has been completely converted, including the terminating null wide character (L\[aq]\e0\[aq]). In this case, the conversion ends in the initial shift state. diff --git a/man3/wprintf.3 b/man3/wprintf.3 index 99f8ad5e15..38feff7f1e 100644 --- a/man3/wprintf.3 +++ b/man3/wprintf.3 @@ -109,15 +109,15 @@ the functions except for the following differences: .TP -.B \(bu +.B \[bu] The .I format string is a wide-character string. .TP -.B \(bu +.B \[bu] The output consists of wide characters, not bytes. .TP -.B \(bu +.B \[bu] .BR swprintf () and .BR vswprintf () |