[cstdint, cinttypes.syn] Reorganize <cstdint> presentation

Author: tkoeppe

source/iostreams.tex

@@ -14967,7 +14967,7 @@
 \indexlibrary{\idxcode{SCNuPTR}}%
 \indexlibrary{\idxcode{SCNxPTR}}%
 \begin{codeblock}
-#include <cstdint>
+#include <cstdint> // see \ref{cstdint}
 
 namespace std {
   using imaxdiv_t = @\seebelow@;

source/support.tex

@@ -1306,7 +1306,7 @@
 
 \rSec1[cstdint]{Integer types}
 
-\rSec2[cstdint.syn]{Header \tcode{<cstdint>} synopsis}
+\synopsis{Header \tcode{<cstdint>} synopsis}
 \indextext{\idxhdr{cstdint}}%
 \indexlibrary{\idxhdr{cstdint}}%
 \indexlibrary{\idxcode{int8_t}}%
@@ -1340,10 +1340,10 @@
 
 \begin{codeblock}
 namespace std {
-  using int8_t         = @\textit{signed integer type}@;  // optional
-  using int16_t        = @\textit{signed integer type}@;  // optional
-  using int32_t        = @\textit{signed integer type}@;  // optional
-  using int64_t        = @\textit{signed integer type}@;  // optional
+  using int8_t         = @\textit{signed integer type}@;    // optional
+  using int16_t        = @\textit{signed integer type}@;    // optional
+  using int32_t        = @\textit{signed integer type}@;    // optional
+  using int64_t        = @\textit{signed integer type}@;    // optional
 
   using int_fast8_t    = @\textit{signed integer type}@;
   using int_fast16_t   = @\textit{signed integer type}@;
@@ -1356,12 +1356,12 @@
   using int_least64_t  = @\textit{signed integer type}@;
 
   using intmax_t       = @\textit{signed integer type}@;
-  using intptr_t       = @\textit{signed integer type}@;   // optional
+  using intptr_t       = @\textit{signed integer type}@;    // optional
 
-  using uint8_t        = @\textit{unsigned integer type}@; // optional
-  using uint16_t       = @\textit{unsigned integer type}@; // optional
-  using uint32_t       = @\textit{unsigned integer type}@; // optional
-  using uint64_t       = @\textit{unsigned integer type}@; // optional
+  using uint8_t        = @\textit{unsigned integer type}@;  // optional
+  using uint16_t       = @\textit{unsigned integer type}@;  // optional
+  using uint32_t       = @\textit{unsigned integer type}@;  // optional
+  using uint64_t       = @\textit{unsigned integer type}@;  // optional
 
   using uint_fast8_t   = @\textit{unsigned integer type}@;
   using uint_fast16_t  = @\textit{unsigned integer type}@;
@@ -1374,32 +1374,53 @@
   using uint_least64_t = @\textit{unsigned integer type}@;
 
   using uintmax_t      = @\textit{unsigned integer type}@;
-  using uintptr_t      = @\textit{unsigned integer type}@; // optional
-} // namespace std
-\end{codeblock}
+  using uintptr_t      = @\textit{unsigned integer type}@;  // optional
+}
 
-\pnum
-The header also defines numerous macros of the form:
+#define INT[8, 16, 32, 64]_MIN @\seebelow@         // optional
+#define INT[8, 16, 32, 64]_MAX @\seebelow@         // optional
+#define UINT[8, 16, 32, 64]_MAX @\seebelow@        // optional
 
-\begin{codeblock}
-  INT_[FAST LEAST]{8 16 32 64}_MIN
-  [U]INT_[FAST LEAST]{8 16 32 64}_MAX
-  INT{MAX PTR}_MIN
-  [U]INT{MAX PTR}_MAX
-  {PTRDIFF SIG_ATOMIC WCHAR WINT}{_MAX _MIN}
-  SIZE_MAX
-\end{codeblock}
+#define INT_LEAST[8, 16, 32, 64]_MIN @\seebelow@
+#define INT_LEAST[8, 16, 32, 64]_MAX @\seebelow@
+#define UINT_LEAST[8, 16, 32, 64]_MAX @\seebelow@
 
-plus function macros of the form:
+#define INT_FAST[8, 16, 32, 64]_MIN @\seebelow@
+#define INT_FAST[8, 16, 32, 64]_MAX @\seebelow@
+#define UINT_FAST[8, 16, 32, 64]_MAX @\seebelow@
 
-\begin{codeblock}
-  [U]INT{8 16 32 64 MAX}_C
+#define INTPTR_MIN @\seebelow@                     // optional
+#define INTPTR_MAX @\seebelow@                     // optional
+#define UINTPTR_MAX @\seebelow@                    // optional
+
+#define INTMAX_MIN @\seebelow@
+#define INTMAX_MAX @\seebelow@
+#define UINTMAX_MAX @\seebelow@
+
+#define PTRDIFF_MIN @\seebelow@
+#define PTRDIFF_MAX @\seebelow@
+#define SIG_ATOMIC_MIN @\seebelow@
+#define SIG_ATOMIC_MAX @\seebelow@
+#define SIZE_MAX @\seebelow@
+
+#define WCHAR_MIN @\seebelow@
+#define WCHAR_MAX @\seebelow@
+#define WINT_MIN @\seebelow@
+#define WINT_MAX @\seebelow@
+
+#define INT[8, 16, 32, 64]_C(value) @\seebelow@    // optional
+#define UINT[8, 16, 32, 64]_C(value) @\seebelow@   // optional
+
+#define INTMAX_C(value) @\seebelow@
+#define UINTMAX_C(value) @\seebelow@
 \end{codeblock}
 
 \pnum
 The header defines all types and macros the same as
 the C standard library header \tcode{<stdint.h>}.
 
+\xref ISO C~7.20.
+
 \rSec1[support.start.term]{Start and termination}
 
 \pnum