[debugging] Move [debugging] to the end of Clause [diagnostics]

Part of the C++26 clause restructuring (#5315).

Author: tkoeppe

source/diagnostics.tex

@@ -20,7 +20,8 @@
 \ref{assertions}      & Assertions            &   \tcode{<cassert>}       \\ \rowsep
 \ref{errno}           & Error numbers         &   \tcode{<cerrno>}        \\ \rowsep
 \ref{syserr}          & System error support  &   \tcode{<system_error>}  \\ \rowsep
-\ref{stacktrace}      & Stacktrace            &   \tcode{<stacktrace>}    \\
+\ref{stacktrace}      & Stacktrace            &   \tcode{<stacktrace>}    \\ \rowsep
+\ref{debugging}       & Debugging             & \tcode{<debugging>}       \\
 \end{libsumtab}
 
 \rSec1[std.exceptions]{Exception classes}
@@ -2485,3 +2486,96 @@
 \pnum
 The specializations are enabled\iref{unord.hash}.
 \end{itemdescr}
+
+\rSec1[debugging]{Debugging}
+
+\rSec2[debugging.general]{General}
+
+\pnum
+Subclause \ref{debugging} describes functionality to introspect and
+interact with the execution of the program.
+
+\begin{note}
+The facilities provided by the debugging functionality interact with a program
+that could be tracing the execution of a \Cpp{} program, such as a debugger.
+\end{note}
+
+\rSec2[debugging.syn]{Header \tcode{<debugging>} synopsis}
+
+\indexheader{debugging}%
+\begin{codeblock}
+// all freestanding
+namespace std {
+  // \ref{debugging.utility}, utility
+  void breakpoint() noexcept;
+  void breakpoint_if_debugging() noexcept;
+  bool is_debugger_present() noexcept;
+}
+\end{codeblock}
+
+\rSec2[debugging.utility]{Utility}
+
+\indexlibraryglobal{breakpoint}%
+\begin{itemdecl}
+void breakpoint() noexcept;
+\end{itemdecl}
+
+\begin{itemdescr}
+
+\pnum
+The semantics of this function are \impldef{semantics of \tcode{breakpoint}}.
+
+\begin{note}
+When invoked, the execution of the program temporarily halts and execution is
+handed to the debugger until such a time as: The program is terminated by the
+debugger, or the debugger resumes execution of the program as if the function
+was not invoked.
+\end{note}
+
+\end{itemdescr}
+
+\indexlibraryglobal{breakpoint_if_debugging}%
+\begin{itemdecl}
+void breakpoint_if_debugging() noexcept;
+\end{itemdecl}
+
+\begin{itemdescr}
+
+\pnum
+\effects
+Equivalent to:
+\begin{codeblock}
+if (is_debugger_present()) breakpoint();
+\end{codeblock}
+
+\end{itemdescr}
+
+\indexlibraryglobal{is_debugger_present}%
+\begin{itemdecl}
+bool is_debugger_present() noexcept;
+\end{itemdecl}
+
+\begin{itemdescr}
+\pnum
+\replaceable
+A \Cpp{} program may define a function with this function signature, and
+thereby displace the default version defined by the \Cpp{} standard library.
+
+\pnum
+\required
+This function has no preconditions.
+
+\pnum
+\default
+\impldef{default semantics of \tcode{is_debugger_present}}.
+
+\begin{note}
+When tracing the execution of a program with a debugger, an implementation
+returns \tcode{true}. An implementation performs an immediate query, as needed,
+to determine if the program is traced by a debugger. On Windows or equivalent
+systems, this can be achieved by calling the \tcode{::IsDebuggerPresent()} Win32
+function. On POSIX, this can be achieved by checking for a tracer parent process,
+with best effort determination that such a tracer parent process is a debugger.
+\end{note}
+
+\end{itemdescr}

source/utilities.tex

@@ -11,7 +11,7 @@
 
 \begin{libsumtab}{General utilities library summary}{utilities.summary}
 \ref{utility}               & Utility components                & \tcode{<utility>}     \\
-\ref{pairs}                 & Pairs                             & \\ \rowsep
+\ref{pairs}                 & Pairs                             &                       \\ \rowsep
 \ref{tuple}                 & Tuples                            & \tcode{<tuple>}       \\ \rowsep
 \ref{optional}              & Optional objects                  & \tcode{<optional>}    \\ \rowsep
 \ref{variant}               & Variants                          & \tcode{<variant>}     \\ \rowsep
@@ -23,8 +23,7 @@
 \ref{execpol}               & Execution policies                & \tcode{<execution>}   \\ \rowsep
 \ref{charconv}              & Primitive numeric conversions     & \tcode{<charconv>}    \\ \rowsep
 \ref{format}                & Formatting                        & \tcode{<format>}      \\ \rowsep
-\ref{bit}                   & Bit manipulation                  & \tcode{<bit>} \\ \rowsep
-\ref{debugging}             & Debugging                         & \tcode{<debugging>} \\
+\ref{bit}                   & Bit manipulation                  & \tcode{<bit>}         \\
 \end{libsumtab}
 
 \rSec1[utility]{Utility components}
@@ -19433,96 +19432,3 @@
 Otherwise, \tcode{endian::native} is not equal
 to either \tcode{endian::big} or \tcode{endian::little}.
 \end{itemdescr}
-
-\rSec1[debugging]{Debugging}
-
-\rSec2[debugging.general]{General}
-
-\pnum
-Subclause \ref{debugging} describes functionality to introspect and
-interact with the execution of the program.
-
-\begin{note}
-The facilities provided by the debugging functionality interact with a program
-that could be tracing the execution of a \Cpp{} program, such as a debugger.
-\end{note}
-
-\rSec2[debugging.syn]{Header \tcode{<debugging>} synopsis}
-
-\indexheader{debugging}%
-\begin{codeblock}
-// all freestanding
-namespace std {
-  // \ref{debugging.utility}, utility
-  void breakpoint() noexcept;
-  void breakpoint_if_debugging() noexcept;
-  bool is_debugger_present() noexcept;
-}
-\end{codeblock}
-
-\rSec2[debugging.utility]{Utility}
-
-\indexlibraryglobal{breakpoint}%
-\begin{itemdecl}
-void breakpoint() noexcept;
-\end{itemdecl}
-
-\begin{itemdescr}
-
-\pnum
-The semantics of this function are \impldef{semantics of \tcode{breakpoint}}.
-
-\begin{note}
-When invoked, the execution of the program temporarily halts and execution is
-handed to the debugger until such a time as: The program is terminated by the
-debugger, or the debugger resumes execution of the program as if the function
-was not invoked.
-\end{note}
-
-\end{itemdescr}
-
-\indexlibraryglobal{breakpoint_if_debugging}%
-\begin{itemdecl}
-void breakpoint_if_debugging() noexcept;
-\end{itemdecl}
-
-\begin{itemdescr}
-
-\pnum
-\effects
-Equivalent to:
-\begin{codeblock}
-if (is_debugger_present()) breakpoint();
-\end{codeblock}
-
-\end{itemdescr}
-
-\indexlibraryglobal{is_debugger_present}%
-\begin{itemdecl}
-bool is_debugger_present() noexcept;
-\end{itemdecl}
-
-\begin{itemdescr}
-\pnum
-\replaceable
-A \Cpp{} program may define a function with this function signature, and
-thereby displace the default version defined by the \Cpp{} standard library.
-
-\pnum
-\required
-This function has no preconditions.
-
-\pnum
-\default
-\impldef{default semantics of \tcode{is_debugger_present}}.
-
-\begin{note}
-When tracing the execution of a program with a debugger, an implementation
-returns \tcode{true}. An implementation performs an immediate query, as needed,
-to determine if the program is traced by a debugger. On Windows or equivalent
-systems, this can be achieved by calling the \tcode{::IsDebuggerPresent()} Win32
-function. On POSIX, this can be achieved by checking for a tracer parent process,
-with best effort determination that such a tracer parent process is a debugger.
-\end{note}
-
-\end{itemdescr}