From bd6fca201551382e12f08de37c1f67bc3deb968d Mon Sep 17 00:00:00 2001 From: "许杰友 Jieyou Xu (Joe)" Date: Wed, 10 Apr 2024 14:17:16 +0000 Subject: Clarify `Command::new` behavior if passed programs with arguments --- library/std/src/process.rs | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) (limited to 'library/std/src') diff --git a/library/std/src/process.rs b/library/std/src/process.rs index c926c89f7a9..f351dab78dc 100644 --- a/library/std/src/process.rs +++ b/library/std/src/process.rs @@ -629,6 +629,25 @@ impl Command { /// .spawn() /// .expect("sh command failed to start"); /// ``` + /// + /// # Caveats + /// + /// [`Command::new`] is only intended to accept the path of the program. If you pass a program + /// path along with arguments like `Command::new("ls -l").spawn()`, it will try to search for + /// `ls -l` literally. The arguments need to be passed separately, such as via [`arg`] or + /// [`args`]. + /// + /// ```no_run + /// use std::process::Command; + /// + /// Command::new("ls") + /// .arg("-l") // arg passed separately + /// .spawn() + /// .expect("ls command failed to start"); + /// ``` + /// + /// [`arg`]: Self::arg + /// [`args`]: Self::args #[stable(feature = "process", since = "1.0.0")] pub fn new>(program: S) -> Command { Command { inner: imp::Command::new(program.as_ref()) } -- cgit 1.4.1-3-g733a5