Signed-off-by: Alejandro Colomar <alx.manpages@xxxxxxxxx> --- man3/intmax_t.3 | 38 +++++++++++++++++++++------ man3/uintmax_t.3 | 2 +- man7/system_data_types.7 | 55 ---------------------------------------- 3 files changed, 31 insertions(+), 64 deletions(-) diff --git a/man3/intmax_t.3 b/man3/intmax_t.3 index e86aac91a..e470c2d3a 100644 --- a/man3/intmax_t.3 +++ b/man3/intmax_t.3 @@ -1,14 +1,16 @@ .TH INTMAX_T 3 2021-11-02 Linux "Linux Programmer's Manual" .SH NAME -intmax_t \- greatest-width basic integer type +intmax_t, uintmax_t \- greatest-width basic integer types .SH SYNOPSIS .nf -.B #include stdint.h> +.B #include <stdint.h> .PP .BR typedef " /* ... */ " intmax_t; +.BR typedef " /* ... */ " uintmax_t; .fi .SH DESCRIPTION -A signed integer type +.I intmax_t +is a signed integer type capable of representing any value of any basic signed integer type supported by the implementation. According to the C language standard, it shall be @@ -16,13 +18,28 @@ capable of storing values in the range .RB [ INTMAX_MIN , .BR INTMAX_MAX ]. .PP +.I uintmax_t +is an unsigned integer type +capable of representing any value of any basic unsigned integer type +supported by the implementation. +According to the C language standard, it shall be +capable of storing values in the range [0, +.BR UINTMAX_MAX ]. +.PP The macro .BR INTMAX_C () expands its argument to an integer constant of type .IR intmax_t . .PP +The macro +.BR UINTMAX_C () +expands its argument to an integer constant of type +.IR uintmax_t . +.PP The length modifier for .I intmax_t +and +.I uintmax_t for the .BR printf (3) and the @@ -30,21 +47,26 @@ and the families of functions is .BR j ; resulting commonly in -.B %jd +.BR %jd , +.BR %ji , +.BR %ju , or -.B %ji +.B %jx for printing .I intmax_t +or +.I uintmax_t values. .SH CONFORMING TO C99 and later; POSIX.1-2001 and later. .SH NOTES -The following header also provides this type: +The following header also provides these types: .IR <inttypes.h> . .SH BUGS -.I intmax_t -may not be as large as extended integer types, such as +These types may not be as large as extended integer types, such as .I __int128 .SH SEE ALSO +.BR int64_t (3), +.BR intptr_t (3), .BR printf (3), .BR strtoimax (3) diff --git a/man3/uintmax_t.3 b/man3/uintmax_t.3 index db50c0f09..404997f45 100644 --- a/man3/uintmax_t.3 +++ b/man3/uintmax_t.3 @@ -1 +1 @@ -.so man7/system_data_types.7 +.so man3/intmax_t.3 diff --git a/man7/system_data_types.7 b/man7/system_data_types.7 index a4a1c3298..4c5ee6625 100644 --- a/man7/system_data_types.7 +++ b/man7/system_data_types.7 @@ -1234,61 +1234,6 @@ POSIX.1-2001 and later. .RE .\"------------------------------------- uid_t ----------------------/ .\"------------------------------------- uintmax_t --------------------/ -.TP -.I uintmax_t -.RS -.IR Include : -.IR <stdint.h> . -Alternatively, -.IR <inttypes.h> . -.PP -An unsigned integer type -capable of representing any value of any unsigned integer type -supported by the implementation. -According to the C language standard, it shall be -capable of storing values in the range [0, -.BR UINTMAX_MAX ]. -.PP -The macro -.BR UINTMAX_C () -.\" TODO: Document UINT*_C(3) -expands its argument to an integer constant of type -.IR uintmax_t . -.PP -The length modifier for -.I uintmax_t -for the -.BR printf (3) -and the -.BR scanf (3) -families of functions is -.BR j ; -resulting commonly in -.B %ju -or -.B %jx -for printing -.I uintmax_t -values. -.PP -.IR "Conforming to" : -C99 and later; POSIX.1-2001 and later. -.PP -.IR Bugs : -.I uintmax_t -is not large enough to represent values of type -.I unsigned __int128 -in implementations where -.I unsigned __int128 -is defined and -.I unsigned long long -is less than 128 bits wide. -.PP -.IR "See also" : -the -.I intmax_t -type in this page. -.RE .\"------------------------------------- uintN_t ----------------------/ .TP .IR uint N _t -- 2.33.1