[RFC 29/37] intmax_t.3, uintmax_t.3, system_data_types.7: Move uintmax_t to intmax_t.3

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



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




[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux