diff options
author | Alejandro Colomar <alx@kernel.org> | 2023-10-31 01:28:55 +0100 |
---|---|---|
committer | Alejandro Colomar <alx@kernel.org> | 2023-10-31 01:37:57 +0100 |
commit | c6d039a3a6edcffa325c584d9942fc64560c32e1 (patch) | |
tree | fe4ac58f924a952635fa4018af95db9d8f64ec62 /man3type | |
parent | 019aad50584289476a9f206adf074326e106713d (diff) |
man*/: srcfix (Use .P instead of .PP or .LP)
We're trying to "standardize" on a paragraphing macro from the three
equivalent ones (P, PP, LP). We (somewhat arbitrarily) agreed on P.
Scripted change:
$ find man* -type f | xargs sed -i '/\.PP/s/PP/P/'
$ find man* -type f | xargs sed -i '/\.LP/s/LP/P/'
Suggested-by: "G. Branden Robinson" <branden@debian.org>
Cc: Ingo Schwarze <schwarze@openbsd.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Diffstat (limited to 'man3type')
33 files changed, 137 insertions, 137 deletions
diff --git a/man3type/FILE.3type b/man3type/FILE.3type index 902557511..5c2dfd1a3 100644 --- a/man3type/FILE.3type +++ b/man3type/FILE.3type @@ -13,7 +13,7 @@ Standard C library .SH SYNOPSIS .nf .B #include <stdio.h> -.PP +.P .BR typedef " /* ... */ " FILE; .fi .SH DESCRIPTION diff --git a/man3type/aiocb.3type b/man3type/aiocb.3type index 945561710..9e7190e68 100644 --- a/man3type/aiocb.3type +++ b/man3type/aiocb.3type @@ -13,7 +13,7 @@ Standard C library .SH SYNOPSIS .EX .B #include <aio.h> -.PP +.P .B struct aiocb { .BR " int aio_fildes;" " /* File descriptor */" .BR " off_t aio_offset;" " /* File offset */" diff --git a/man3type/blkcnt_t.3type b/man3type/blkcnt_t.3type index 6b7836115..32c20cc0e 100644 --- a/man3type/blkcnt_t.3type +++ b/man3type/blkcnt_t.3type @@ -13,7 +13,7 @@ Standard C library .SH SYNOPSIS .nf .B #include <sys/types.h> -.PP +.P .BR typedef " /* ... */ " blkcnt_t; .fi .SH DESCRIPTION diff --git a/man3type/blksize_t.3type b/man3type/blksize_t.3type index 5c0a24e81..7384a38e1 100644 --- a/man3type/blksize_t.3type +++ b/man3type/blksize_t.3type @@ -13,7 +13,7 @@ Standard C library .SH SYNOPSIS .nf .B #include <sys/types.h> -.PP +.P .BR typedef " /* ... */ " blksize_t; .fi .SH DESCRIPTION diff --git a/man3type/cc_t.3type b/man3type/cc_t.3type index f0c7a490c..811233193 100644 --- a/man3type/cc_t.3type +++ b/man3type/cc_t.3type @@ -13,7 +13,7 @@ Standard C library .SH SYNOPSIS .nf .B #include <termios.h> -.PP +.P .BR typedef " /* ... */ " cc_t; .BR typedef " /* ... */ " speed_t; .BR typedef " /* ... */ " tcflag_t; @@ -25,7 +25,7 @@ is used for terminal special characters, for baud rates, and .I tcflag_t for modes. -.PP +.P All are unsigned integer types. .SH STANDARDS POSIX.1-2008. diff --git a/man3type/clock_t.3type b/man3type/clock_t.3type index 77d16052e..b6248a93d 100644 --- a/man3type/clock_t.3type +++ b/man3type/clock_t.3type @@ -13,7 +13,7 @@ Standard C library .SH SYNOPSIS .nf .B #include <time.h> -.PP +.P .BR typedef " /* ... */ " clock_t; .fi .SH DESCRIPTION diff --git a/man3type/clockid_t.3type b/man3type/clockid_t.3type index 97ce86661..38d760f80 100644 --- a/man3type/clockid_t.3type +++ b/man3type/clockid_t.3type @@ -7,7 +7,7 @@ Standard C library .SH SYNOPSIS .nf .B #include <sys/types.h> -.PP +.P .BR typedef " /* ... */ " clockid_t; .fi .SH DESCRIPTION diff --git a/man3type/dev_t.3type b/man3type/dev_t.3type index 0a3df9353..dd68f2603 100644 --- a/man3type/dev_t.3type +++ b/man3type/dev_t.3type @@ -13,7 +13,7 @@ Standard C library .SH SYNOPSIS .nf .B #include <sys/types.h> -.PP +.P .BR typedef " /* ... */ " dev_t; .fi .SH DESCRIPTION diff --git a/man3type/div_t.3type b/man3type/div_t.3type index d62ea2cca..857dae17e 100644 --- a/man3type/div_t.3type +++ b/man3type/div_t.3type @@ -14,24 +14,24 @@ Standard C library .SH SYNOPSIS .EX .B #include <stdlib.h> -.PP +.P .B typedef struct { .BR " int quot;" " /* Quotient */" .BR " int rem;" " /* Remainder */" .B } div_t; -.PP +.P .B typedef struct { .BR " long quot;" " /* Quotient */" .BR " long rem;" " /* Remainder */" .B } ldiv_t; -.PP +.P .B typedef struct { .BR " long long quot;" " /* Quotient */" .BR " long long rem;" " /* Remainder */" .B } lldiv_t; -.PP +.P .B #include <inttypes.h> -.PP +.P .B typedef struct { .BR " intmax_t quot;" " /* Quotient */" .BR " intmax_t rem;" " /* Remainder */" @@ -42,7 +42,7 @@ Standard C library is the type of the value returned by the .RB [[ l ] l ] div (3) function. -.PP +.P .I imaxdiv_t is the type of the value returned by the .BR imaxdiv (3) diff --git a/man3type/double_t.3type b/man3type/double_t.3type index 1bf1946eb..369867060 100644 --- a/man3type/double_t.3type +++ b/man3type/double_t.3type @@ -14,7 +14,7 @@ Math library .SH SYNOPSIS .nf .B #include <math.h> -.PP +.P .BR typedef " /* ... */ " float_t; .BR typedef " /* ... */ " double_t; .fi @@ -28,7 +28,7 @@ Their type depends on the value of the macro .B FLT_EVAL_METHOD (defined in .IR <float.h> ): -.PP +.P .TS lB rI rI. FLT_EVAL_METHOD float_t double_t @@ -39,7 +39,7 @@ _ 1 double double 2 long double long double .TE -.PP +.P For other values of .BR FLT_EVAL_METHOD , the types of diff --git a/man3type/epoll_event.3type b/man3type/epoll_event.3type index 0d335c5b0..1e70af79c 100644 --- a/man3type/epoll_event.3type +++ b/man3type/epoll_event.3type @@ -13,19 +13,19 @@ Standard C library .SH SYNOPSIS .EX .B #include <sys/epoll.h> -.PP +.P .B struct epoll_event { .BR " uint32_t events;" " /* Epoll events */" .BR " epoll_data_t data;" " /* User data variable */" .B }; -.PP +.P .B union epoll_data { .B " void *ptr;" .B " int fd;" .B " uint32_t u32;" .B " uint64_t u64;" .B }; -.PP +.P .B "typedef union epoll_data epoll_data_t;" .EE .SH DESCRIPTION @@ -37,7 +37,7 @@ return when the corresponding file descriptor becomes ready. .SS C library/kernel differences The Linux kernel headers also provide this type, with a slightly different definition: -.PP +.P .in +4n .EX #include <linux/eventpoll.h> diff --git a/man3type/fenv_t.3type b/man3type/fenv_t.3type index 9e2202257..6b5886665 100644 --- a/man3type/fenv_t.3type +++ b/man3type/fenv_t.3type @@ -13,7 +13,7 @@ Standard C library .SH SYNOPSIS .nf .B #include <fenv.h> -.PP +.P .BR typedef " /* ... */ " fenv_t; .BR typedef " /* ... */ " fexcept_t; .fi @@ -21,10 +21,10 @@ Standard C library .I fenv_t represents the entire floating-point environment, including control modes and status flags. -.PP +.P .I fexcept_t represents the floating-point status flags collectively. -.PP +.P For further details see .BR fenv (3). .SH STANDARDS diff --git a/man3type/id_t.3type b/man3type/id_t.3type index 4c76ad2f6..3a9450e9e 100644 --- a/man3type/id_t.3type +++ b/man3type/id_t.3type @@ -13,7 +13,7 @@ Standard C library .SH SYNOPSIS .nf .B #include <sys/types.h> -.PP +.P .BR typedef " /* ... */ " pid_t; .BR typedef " /* ... */ " uid_t; .BR typedef " /* ... */ " gid_t; @@ -23,15 +23,15 @@ Standard C library .I pid_t is a type used for storing process IDs, process group IDs, and session IDs. It is a signed integer type. -.PP +.P .I uid_t is a type used to hold user IDs. It is an integer type. -.PP +.P .I gid_t is a type used to hold group IDs. It is an integer type. -.PP +.P .I id_t is a type used to hold a general identifier. It is an integer type that can be used to contain a @@ -59,7 +59,7 @@ The following headers also provide .IR <unistd.h> , and .IR <utmpx.h> . -.PP +.P The following headers also provide .IR uid_t : .IR <pwd.h> , @@ -69,7 +69,7 @@ The following headers also provide .IR <sys/stat.h> , and .IR <unistd.h> . -.PP +.P The following headers also provide .IR gid_t : .IR <grp.h> , @@ -80,7 +80,7 @@ The following headers also provide .IR <sys/stat.h> , and .IR <unistd.h> . -.PP +.P The following header also provides .IR id_t : .IR <sys/resource.h> . diff --git a/man3type/intN_t.3type b/man3type/intN_t.3type index 3a1e51518..eefcb33cc 100644 --- a/man3type/intN_t.3type +++ b/man3type/intN_t.3type @@ -15,47 +15,47 @@ Standard C library .SH SYNOPSIS .nf .B #include <stdint.h> -.PP +.P .BR typedef " /* ... */ " int8_t; .BR typedef " /* ... */ " int16_t; .BR typedef " /* ... */ " int32_t; .BR typedef " /* ... */ " int64_t; -.PP +.P .BR typedef " /* ... */ " uint8_t; .BR typedef " /* ... */ " uint16_t; .BR typedef " /* ... */ " uint32_t; .BR typedef " /* ... */ " uint64_t; -.PP +.P .B "#define INT8_WIDTH 8" .B "#define INT16_WIDTH 16" .B "#define INT32_WIDTH 32" .B "#define INT64_WIDTH 64" -.PP +.P .B "#define UINT8_WIDTH 8" .B "#define UINT16_WIDTH 16" .B "#define UINT32_WIDTH 32" .B "#define UINT64_WIDTH 64" -.PP +.P .BR "#define INT8_MAX " "/* 2**(INT8_WIDTH - 1) - 1 */" .BR "#define INT16_MAX " "/* 2**(INT16_WIDTH - 1) - 1 */" .BR "#define INT32_MAX " "/* 2**(INT32_WIDTH - 1) - 1 */" .BR "#define INT64_MAX " "/* 2**(INT64_WIDTH - 1) - 1 */" -.PP +.P .BR "#define INT8_MIN " "/* - 2**(INT8_WIDTH - 1) */" .BR "#define INT16_MIN " "/* - 2**(INT16_WIDTH - 1) */" .BR "#define INT32_MIN " "/* - 2**(INT32_WIDTH - 1) */" .BR "#define INT64_MIN " "/* - 2**(INT64_WIDTH - 1) */" -.PP +.P .BR "#define UINT8_MAX " "/* 2**INT8_WIDTH - 1 */" .BR "#define UINT16_MAX " "/* 2**INT16_WIDTH - 1 */" .BR "#define UINT32_MAX " "/* 2**INT32_WIDTH - 1 */" .BR "#define UINT64_MAX " "/* 2**INT64_WIDTH - 1 */" -.PP +.P .BI "#define INT8_C(" c ") " c " ## " "\fR/* ... */\fP" .BI "#define INT16_C(" c ") " c " ## " "\fR/* ... */\fP" .BI "#define INT32_C(" c ") " c " ## " "\fR/* ... */\fP" .BI "#define INT64_C(" c ") " c " ## " "\fR/* ... */\fP" -.PP +.P .BI "#define UINT8_C(" c ") " c " ## " "\fR/* ... */\fP" .BI "#define UINT16_C(" c ") " c " ## " "\fR/* ... */\fP" .BI "#define UINT32_C(" c ") " c " ## " "\fR/* ... */\fP" @@ -74,7 +74,7 @@ They are be capable of storing values in the range substituting .I N by the appropriate number. -.PP +.P .IR uint N _t are unsigned integer types @@ -86,7 +86,7 @@ They are capable of storing values in the range substituting .I N by the appropriate number. -.PP +.P According to POSIX, .RI [ u ] int8_t , .RI [ u ] int16_t , @@ -96,25 +96,25 @@ are required; .RI [ u ] int64_t are only required in implementations that provide integer types with width 64; and all other types of this form are optional. -.PP +.P The macros .RB [ U ] INT \fIN\fP _WIDTH expand to the width in bits of these types .RI ( N ). -.PP +.P The macros .RB [ U ] INT \fIN\fP _MAX expand to the maximum value that these types can hold. -.PP +.P The macros .BI INT N _MIN expand to the minimum value that these types can hold. -.PP +.P The macros .RB [ U ] INT \fIN\fP _C () expand their argument to an integer constant of type .RI [ u ] int N _t . -.PP +.P The length modifiers for the .RI [ u ] int N _t types for the @@ -159,7 +159,7 @@ values. C11, POSIX.1-2008. .SH HISTORY C99, POSIX.1-2001. -.PP +.P The .RB [ U ] INT \fIN\fP _WIDTH macros were added in C23. diff --git a/man3type/intmax_t.3type b/man3type/intmax_t.3type index e5feb4c56..dba108114 100644 --- a/man3type/intmax_t.3type +++ b/man3type/intmax_t.3type @@ -13,17 +13,17 @@ Standard C library .SH SYNOPSIS .nf .B #include <stdint.h> -.PP +.P .BR typedef " /* ... */ " intmax_t; .BR typedef " /* ... */ " uintmax_t; -.PP +.P .BR "#define INTMAX_WIDTH " "/* ... */" .B "#define UINTMAX_WIDTH INTMAX_WIDTH" -.PP +.P .BR "#define INTMAX_MAX " "/* 2**(INTMAX_WIDTH - 1) - 1 */" .BR "#define INTMAX_MIN " "/* - 2**(INTMAX_WIDTH - 1) */" .BR "#define UINTMAX_MAX " "/* 2**UINTMAX_WIDTH - 1 */" -.PP +.P .BI "#define INTMAX_C(" c ) " c " ## " \fR/* ... */\fP" .BI "#define UINTMAX_C(" c ) " c " ## " \fR/* ... */\fP" .fi @@ -35,7 +35,7 @@ supported by the implementation. It is capable of storing values in the range .RB [ INTMAX_MIN , .BR INTMAX_MAX ]. -.PP +.P .I uintmax_t is an unsigned integer type capable of representing any value of any basic unsigned integer type @@ -43,26 +43,26 @@ supported by the implementation. It is capable of storing values in the range .RB [ 0 , .BR UINTMAX_MAX ]. -.PP +.P The macros .RB [ U ] INTMAX_WIDTH expand to the width in bits of these types. -.PP +.P The macros .RB [ U ] INTMAX_MAX expand to the maximum value that these types can hold. -.PP +.P The macro .B INTMAX_MIN expands to the minimum value that .I intmax_t can hold. -.PP +.P The macros .RB [ U ] INTMAX_C () expand their argument to an integer constant of type .RI [ u ] intmax_t . -.PP +.P The length modifier for .RI [ u ] intmax_t for the diff --git a/man3type/intptr_t.3type b/man3type/intptr_t.3type index 9481baf91..ac7b18214 100644 --- a/man3type/intptr_t.3type +++ b/man3type/intptr_t.3type @@ -13,13 +13,13 @@ Standard C library .SH SYNOPSIS .nf .B #include <stdint.h> -.PP +.P .BR typedef " /* ... */ " intptr_t; .BR typedef " /* ... */ " uintptr_t; -.PP +.P .BR "#define INTPTR_WIDTH" " /* ... */" .B #define UINTPTR_WIDTH INTPTR_WIDTH -.PP +.P .BR "#define INTPTR_MAX" " /* 2**(INTPTR_WIDTH \- 1) \- 1 */" .BR "#define INTPTR_MIN" " /* \- 2**(INTPTR_WIDTH \- 1) */" .BR "#define UINTPTR_MAX" " /* 2**UINTPTR_WIDTH \- 1 */" @@ -33,7 +33,7 @@ value can be converted to this type and then converted back. It is capable of storing values in the range .RB [ INTPTR_MIN , .BR INTPTR_MAX ]. -.PP +.P .I uintptr_t is an unsigned integer type such that any valid @@ -42,21 +42,21 @@ value can be converted to this type and then converted back. It is capable of storing values in the range .RB [ 0 , .BR INTPTR_MAX ]. -.PP +.P The macros .RB [ U ] INTPTR_WIDTH expand to the width in bits of these types. -.PP +.P The macros .RB [ U ] INTPTR_MAX expand to the maximum value that these types can hold. -.PP +.P The macro .B INTPTR_MIN expands to the minimum value that .I intptr_t can hold. -.PP +.P The length modifiers for the .RI [ u ] intptr_t types diff --git a/man3type/iovec.3type b/man3type/iovec.3type index 559883183..14d2c40f4 100644 --- a/man3type/iovec.3type +++ b/man3type/iovec.3type @@ -12,7 +12,7 @@ Standard C library .SH SYNOPSIS .EX .B #include <sys/uio.h> -.PP +.P .B struct iovec { .BR " void *iov_base;" " /* Starting address */" .BR " size_t iov_len;" " /* Size of the memory pointed to by "\c diff --git a/man3type/itimerspec.3type b/man3type/itimerspec.3type index 862235fa9..d6413d218 100644 --- a/man3type/itimerspec.3type +++ b/man3type/itimerspec.3type @@ -12,7 +12,7 @@ Standard C library .SH SYNOPSIS .EX .B #include <time.h> -.PP +.P .B struct itimerspec { .BR " struct timespec it_interval;" " /* Interval for periodic timer */" .BR " struct timespec it_value;" " /* Initial expiration */" diff --git a/man3type/lconv.3type b/man3type/lconv.3type index 5c326d7c9..5757cd068 100644 --- a/man3type/lconv.3type +++ b/man3type/lconv.3type @@ -13,7 +13,7 @@ Standard C library .SH SYNOPSIS .EX .B #include <locale.h> -.PP +.P .BR "struct lconv {" " /* Values in the \[dq]C\[dq] locale: */" .BR " char *decimal_point;" " /* \[dq].\[dq] */" .BR " char *thousands_sep;" " /* \[dq]\[dq] */" diff --git a/man3type/mode_t.3type b/man3type/mode_t.3type index c90a35fb0..c332eeb75 100644 --- a/man3type/mode_t.3type +++ b/man3type/mode_t.3type @@ -13,7 +13,7 @@ Standard C library .SH SYNOPSIS .nf .B #include <sys/types.h> -.PP +.P .BR typedef " /* ... */ " mode_t; .fi .SH DESCRIPTION diff --git a/man3type/off_t.3type b/man3type/off_t.3type index 4d4bae143..4b3838917 100644 --- a/man3type/off_t.3type +++ b/man3type/off_t.3type @@ -13,28 +13,28 @@ Standard C library .SH SYNOPSIS .nf .B #include <sys/types.h> -.PP +.P .BR typedef " /* ... */ " off_t; -.PP +.P .B #define _LARGEFILE64_SOURCE .B #include <sys/types.h> -.PP +.P .BR typedef " /* ... */ " off64_t; -.PP +.P .B #define _GNU_SOURCE .B #include <sys/types.h> -.PP +.P .BR typedef " /* ... */ " loff_t; .fi .SH DESCRIPTION .I off_t is used for describing file sizes. It is a signed integer type. -.PP +.P .I off64_t is a 64-bit version of the type, used in glibc. -.PP +.P .I loff_t is a 64-bit version of the type, introduced by the Linux kernel. @@ -52,7 +52,7 @@ Linux. .TP .I off_t POSIX.1-2001. -.PP +.P .I <aio.h> and .I <stdio.h> @@ -65,7 +65,7 @@ the width of .I off_t can be controlled with the feature test macro .BR _FILE_OFFSET_BITS . -.PP +.P The following headers also provide .IR off_t : .IR <aio.h> , diff --git a/man3type/ptrdiff_t.3type b/man3type/ptrdiff_t.3type index 11bd5c4dc..5a881dd9b 100644 --- a/man3type/ptrdiff_t.3type +++ b/man3type/ptrdiff_t.3type @@ -13,7 +13,7 @@ Standard C library .SH SYNOPSIS .nf .B #include <stddef.h> -.PP +.P .BR typedef " /* ... */ " ptrdiff_t; .fi .SH DESCRIPTION @@ -23,7 +23,7 @@ It is a signed integer type capable of storing values in the range .RB [ PTRDIFF_MIN , .BR PTRDIFF_MAX ]. -.PP +.P The length modifier for .I ptrdiff_t for the diff --git a/man3type/sigevent.3type b/man3type/sigevent.3type index 161e12665..01ca76620 100644 --- a/man3type/sigevent.3type +++ b/man3type/sigevent.3type @@ -10,7 +10,7 @@ sigevent, sigval \- structure for notification from asynchronous routines .SH SYNOPSIS .EX .B #include <signal.h> -.PP +.P .B struct sigevent { .BR " int sigev_notify;" " /* Notification type */" .BR " int sigev_signo;" " /* Signal number */" @@ -27,7 +27,7 @@ sigevent, sigval \- structure for notification from asynchronous routines .BR " " " /* ID of thread to signal" .BR " " " (SIGEV_THREAD_ID) */" .B }; -.PP +.P .BR "union sigval {" " /* Data passed with notification */" .BR " int sival_int;" " /* Integer value */" .BR " void *sival_ptr;" " /* Pointer value */" @@ -41,7 +41,7 @@ structure is used by various APIs to describe the way a process is to be notified about an event (e.g., completion of an asynchronous request, expiration of a timer, or the arrival of a message). -.PP +.P The definition shown in the SYNOPSIS is approximate: some of the fields in the .I sigevent @@ -49,7 +49,7 @@ structure may be defined as part of a union. Programs should employ only those fields relevant to the value specified in .IR sigev_notify . -.PP +.P The .I sigev_notify field specifies how notification is to be performed. @@ -117,7 +117,7 @@ Data passed with a signal. POSIX.1-2008. .SH HISTORY POSIX.1-2001. -.PP +.P .I <aio.h> and .I <time.h> diff --git a/man3type/size_t.3type b/man3type/size_t.3type index 1c5894f45..92efc8139 100644 --- a/man3type/size_t.3type +++ b/man3type/size_t.3type @@ -13,11 +13,11 @@ Standard C library .SH SYNOPSIS .nf .B #include <stddef.h> -.PP +.P .BR typedef " /* ... */ " size_t; -.PP +.P .B #include <sys/types.h> -.PP +.P .BR typedef " /* ... */ " ssize_t; .fi .SH DESCRIPTION @@ -99,7 +99,7 @@ C89, POSIX.1-2001. .TP .I ssize_t POSIX.1-2001. -.PP +.P .IR <aio.h> , .IR <glob.h> , .IR <grp.h> , @@ -112,7 +112,7 @@ and define .I size_t since POSIX.1-2008. -.PP +.P .IR <aio.h> , .IR <mqueue.h> , and diff --git a/man3type/sockaddr.3type b/man3type/sockaddr.3type index cf8d601f5..10659ca45 100644 --- a/man3type/sockaddr.3type +++ b/man3type/sockaddr.3type @@ -15,30 +15,30 @@ Standard C library .SH SYNOPSIS .EX .B #include <sys/socket.h> -.PP +.P .B struct sockaddr { .BR " sa_family_t sa_family;" " /* Address family */" .BR " char sa_data[];" " /* Socket address */" .B }; -.PP +.P .B struct sockaddr_storage { .BR " sa_family_t ss_family;" " /* Address family */" .B }; -.PP +.P .BR typedef " /* ... */ " socklen_t; .BR typedef " /* ... */ " sa_family_t; -.PP +.P .EE .SS Internet domain sockets .EX .B #include <netinet/in.h> -.PP +.P .B struct sockaddr_in { .BR " sa_family_t sin_family;" " /* " AF_INET " */" .BR " in_port_t sin_port;" " /* Port number */" .BR " struct in_addr sin_addr;" " /* IPv4 address */" .B }; -.PP +.P .B struct sockaddr_in6 { .BR " sa_family_t sin6_family;" " /* " AF_INET6 " */" .BR " in_port_t sin6_port;" " /* Port number */" @@ -46,22 +46,22 @@ Standard C library .BR " struct in6_addr sin6_addr;" " /* IPv6 address */" .BR " uint32_t sin6_scope_id;" " /* Set of interfaces for a scope */" .B }; -.PP +.P .B struct in_addr { .B " in_addr_t s_addr;" .B }; -.PP +.P .B struct in6_addr { .B " uint8_t s6_addr[16];" .B }; -.PP +.P .B typedef uint32_t in_addr_t; .B typedef uint16_t in_port_t; .EE .SS UNIX domain sockets .EX .B #include <sys/un.h> -.PP +.P .B struct sockaddr_un { .BR " sa_family_t sun_family;" " /* Address family */" .BR " char sun_path[];" " /* Socket pathname */" @@ -112,12 +112,12 @@ Describes a UNIX domain socket address. POSIX.1-2008. .SH HISTORY POSIX.1-2001. -.PP +.P .I socklen_t was invented by POSIX. See also .BR accept (2). -.PP +.P These structures were invented before modern ISO C strict-aliasing rules. If aliasing rules are applied strictly, these structures would be extremely difficult to use @@ -129,7 +129,7 @@ can be safely used as they were designed. .I socklen_t is also defined in .IR <netdb.h> . -.PP +.P .I sa_family_t is also defined in .I <netinet/in.h> diff --git a/man3type/stat.3type b/man3type/stat.3type index 939dc3c8f..0eddda880 100644 --- a/man3type/stat.3type +++ b/man3type/stat.3type @@ -13,7 +13,7 @@ Standard C library .SH SYNOPSIS .EX .B #include <sys/stat.h> -.PP +.P .B struct stat { .BR " dev_t st_dev;" " /* ID of device containing file */" .BR " ino_t st_ino;" " /* Inode number */" @@ -39,12 +39,12 @@ Standard C library .B "#define st_ctime st_ctim.tv_sec" .B }; .EE -.PP +.P .RS -4 Feature Test Macro Requirements for glibc (see .BR feature_test_macros (7)): .RE -.PP +.P .IR st_atim , .IR st_mtim , .IR st_ctim : @@ -56,7 +56,7 @@ Feature Test Macro Requirements for glibc (see .fi .SH DESCRIPTION Describes information about a file. -.PP +.P The fields are as follows: .TP .I st_dev @@ -113,14 +113,14 @@ This is the time of last modification of file data. .I st_ctime This is the file's last status change timestamp (time of last change to the inode). -.PP +.P For further information on the above fields, see .BR inode (7). .SH STANDARDS POSIX.1-2008. .SH HISTORY POSIX.1-2001. -.PP +.P Old kernels and old standards did not support nanosecond timestamp fields. Instead, there were three timestamp .RI fields\[em] st_atime , @@ -130,7 +130,7 @@ and as .I time_t that recorded timestamps with one-second precision. -.PP +.P Since Linux 2.5.48, the .I stat structure supports nanosecond resolution for the three file timestamp fields. diff --git a/man3type/time_t.3type b/man3type/time_t.3type index 2ba4f6833..fb788b823 100644 --- a/man3type/time_t.3type +++ b/man3type/time_t.3type @@ -13,11 +13,11 @@ Standard C library .SH SYNOPSIS .nf .B #include <time.h> -.PP +.P .BR typedef " /* ... */ " time_t; -.PP +.P .B #include <sys/types.h> -.PP +.P .BR typedef " /* ... */ " suseconds_t; .BR typedef " /* ... */ " useconds_t; .fi @@ -64,12 +64,12 @@ C89, POSIX.1-2001. .TQ .I useconds_t POSIX.1-2001. -.PP +.P .I <sched.h> defines .I time_t since POSIX.1-2008. -.PP +.P POSIX.1-2001 defined .I useconds_t in @@ -81,7 +81,7 @@ the width of .I time_t can be controlled with the feature test macro .BR _TIME_BITS . -.PP +.P The following headers also provide .IR time_t : .IR <sched.h> , @@ -94,7 +94,7 @@ The following headers also provide .IR <sys/types.h> , and .IR <utime.h> . -.PP +.P The following headers also provide .IR suseconds_t : .I <sys/select.h> diff --git a/man3type/timer_t.3type b/man3type/timer_t.3type index 6470855f7..c0b2afa8b 100644 --- a/man3type/timer_t.3type +++ b/man3type/timer_t.3type @@ -13,7 +13,7 @@ Standard C library .SH SYNOPSIS .nf .B #include <sys/types.h> -.PP +.P .BR typedef " /* ... */ " timer_t; .fi .SH DESCRIPTION diff --git a/man3type/timespec.3type b/man3type/timespec.3type index b5028a105..7f5c97cd6 100644 --- a/man3type/timespec.3type +++ b/man3type/timespec.3type @@ -13,7 +13,7 @@ Standard C library .SH SYNOPSIS .EX .B #include <time.h> -.PP +.P .B struct timespec { .BR " time_t tv_sec;" " /* Seconds */" .RB " /* ... */" " tv_nsec;" \ @@ -22,7 +22,7 @@ Standard C library .EE .SH DESCRIPTION Describes times in seconds and nanoseconds. -.PP +.P .I tv_nsec is of an implementation-defined signed type capable of holding the specified range. diff --git a/man3type/timeval.3type b/man3type/timeval.3type index c8963ef4a..7223c7b09 100644 --- a/man3type/timeval.3type +++ b/man3type/timeval.3type @@ -13,7 +13,7 @@ Standard C library .SH SYNOPSIS .EX .B #include <sys/time.h> -.PP +.P .B struct timeval { .BR " time_t tv_sec;" " /* Seconds */" .BR " suseconds_t tv_usec;" " /* Microseconds */" diff --git a/man3type/tm.3type b/man3type/tm.3type index e203b15e7..5d5b28658 100644 --- a/man3type/tm.3type +++ b/man3type/tm.3type @@ -12,7 +12,7 @@ Standard C library .SH SYNOPSIS .EX .B #include <time.h> -.PP +.P .B struct tm { .BR " int tm_sec;" " /* Seconds [" 0 ", " 60 "] */" .BR " int tm_min;" " /* Minutes [" 0 ", " 59 "] */" @@ -26,17 +26,17 @@ Standard C library .BR " int tm_yday;" \ " /* Day of the year [" 0 ", " 365 "] (Jan/01 = " 0 ") */" .BR " int tm_isdst;" " /* Daylight savings flag */" -.PP +.P .BR " long tm_gmtoff;" " /* Seconds East of UTC */" .BR " const char *tm_zone;" " /* Timezone abbreviation */" .B }; .EE -.PP +.P .RS -4 Feature Test Macro Requirements for glibc (see .BR feature_test_macros (7)): .RE -.PP +.P .IR tm_gmtoff , .IR tm_zone : .nf @@ -48,19 +48,19 @@ Feature Test Macro Requirements for glibc (see .fi .SH DESCRIPTION Describes time, broken down into distinct components. -.PP +.P .I tm_isdst describes whether daylight saving time is in effect at the time described. The value is positive if daylight saving time is in effect, zero if it is not, and negative if the information is not available. -.PP +.P .I tm_gmtoff is the difference, in seconds, of the timezone represented by this broken-down time and UTC (this is the additive inverse of .BR timezone (3)). -.PP +.P .I tm_zone is the equivalent of .BR tzname (3) @@ -75,7 +75,7 @@ UTC doesn't permit double leap seconds, so it was limited to .B 60 in C99. -.PP +.P .BR timezone (3), as a variable, is an XSI extension: some systems provide the V7-compatible .\" FreeBSD @@ -84,7 +84,7 @@ function. The .I tm_gmtoff field provides an alternative (with the opposite sign) for those systems. -.PP +.P .I tm_zone points to static storage and may be overridden on subsequent calls to .BR localtime (3) @@ -93,7 +93,7 @@ and similar functions (however, this never happens under glibc). C11, POSIX.1-2008. .SH HISTORY C89, POSIX.1-2001. -.PP +.P .I tm_gmtoff and .I tm_zone diff --git a/man3type/va_list.3type b/man3type/va_list.3type index 08b1abfdd..800f80b43 100644 --- a/man3type/va_list.3type +++ b/man3type/va_list.3type @@ -13,7 +13,7 @@ Standard C library .SH SYNOPSIS .nf .B #include <stdarg.h> -.PP +.P .BR typedef " /* ... */ " va_list; .fi .SH DESCRIPTION diff --git a/man3type/void.3type b/man3type/void.3type index c8a638a78..91d458ff7 100644 --- a/man3type/void.3type +++ b/man3type/void.3type @@ -20,7 +20,7 @@ including pointers to functions, may be converted to a pointer to .I void and back. -.PP +.P Conversions from and to any other pointer type are done implicitly, not requiring casts at all. Note that this feature prevents any kind of type checking: @@ -28,13 +28,13 @@ the programmer should be careful not to convert a .I void * value to a type incompatible to that of the underlying data, because that would result in undefined behavior. -.PP +.P This type is useful in function parameters and return value to allow passing values of any type. The function will typically use some mechanism to know the real type of the data being passed via a pointer to .IR void . -.PP +.P A value of this type can't be dereferenced, as it would give a value of type .IR void , |