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

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

Author: tkoeppe

source/diagnostics.tex

@@ -2485,3 +2485,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

@@ -19433,96 +19433,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}