From 23958ba6f78e830ef561a529df06ced5f1bb2483 Mon Sep 17 00:00:00 2001
From: Niklas Fiekas <niklas.fiekas@backscattering.de>
Date: Sat, 27 Jul 2024 13:16:40 +0200
Subject: [PATCH] process: stabilize `Command::process_group`

---
 tokio/src/process/mod.rs | 31 ++++++++++++++++++-------------
 1 file changed, 18 insertions(+), 13 deletions(-)

diff --git a/tokio/src/process/mod.rs b/tokio/src/process/mod.rs
index fc768809f02..54d573e00e9 100644
--- a/tokio/src/process/mod.rs
+++ b/tokio/src/process/mod.rs
@@ -751,29 +751,34 @@ impl Command {
     ///
     /// Process groups determine which processes receive signals.
     ///
-    /// **Note**: This is an [unstable API][unstable] but will be stabilised once
-    /// tokio's `MSRV` is sufficiently new. See [the documentation on
-    /// unstable features][unstable] for details about using unstable features.
+    /// # Examples
+    ///
+    /// Pressing Ctrl-C in a terminal will send SIGINT to all processes
+    /// in the current foreground process group. By spawning the `sleep`
+    /// subprocess in a new process group, it will not receive SIGINT
+    /// from the terminal.
     ///
-    /// If you want similar behavior without using this unstable feature you can
-    /// create a [`std::process::Command`] and convert that into a
-    /// [`tokio::process::Command`] using the `From` trait.
+    /// The parent process could install a [signal handler] and manage the
+    /// process on its own terms.
     ///
-    /// [unstable]: crate#unstable-features
-    /// [`tokio::process::Command`]: crate::process::Command
+    /// A process group ID of 0 will use the process ID as the PGID.
     ///
     /// ```no_run
     /// # async fn test() { // allow using await
     /// use tokio::process::Command;
     ///
-    /// let output = Command::new("ls")
-    ///         .process_group(0)
-    ///         .output().await.unwrap();
+    /// let output = Command::new("sleep")
+    ///     .arg("10")
+    ///     .process_group(0)
+    ///     .output()
+    ///     .await
+    ///     .unwrap();
     /// # }
     /// ```
+    ///
+    /// [signal handler]: crate::signal
     #[cfg(unix)]
-    #[cfg(tokio_unstable)]
-    #[cfg_attr(docsrs, doc(cfg(all(unix, tokio_unstable))))]
+    #[cfg_attr(docsrs, doc(cfg(unix)))]
     pub fn process_group(&mut self, pgroup: i32) -> &mut Command {
         self.std.process_group(pgroup);
         self