docs: Reduce main's in doctests

Author: epage

clap_builder/src/builder/command.rs

@@ -613,10 +613,8 @@ impl Command {
     ///     cmd().debug_assert();
     /// }
     ///
-    /// fn main() {
-    ///     let m = cmd().get_matches_from(vec!["foo", "-b"]);
-    ///     println!("{}", m.get_flag("bar"));
-    /// }
+    /// let m = cmd().get_matches_from(vec!["foo", "-b"]);
+    /// println!("{}", m.get_flag("bar"));
     /// ```
     #[allow(clippy::test_attr_in_doctest)]
     pub fn debug_assert(mut self) {

clap_complete/src/aot/generator/mod.rs

@@ -146,11 +146,9 @@ pub trait Generator {
 ///
 /// mod cli;
 ///
-/// fn main() {
-///     let _m = cli::build_cli().get_matches();
+/// let _m = cli::build_cli().get_matches();
 ///
-///     // normal logic continues...
-/// }
+/// // normal logic continues...
 /// ```
 ///
 /// Next, we set up our `Cargo.toml` to use a `build.rs` build script.
@@ -176,24 +174,22 @@ pub trait Generator {
 ///
 /// include!("src/cli.rs");
 ///
-/// fn main() -> Result<(), Error> {
-///     let outdir = match env::var_os("OUT_DIR") {
-///         None => return Ok(()),
-///         Some(outdir) => outdir,
-///     };
+/// let outdir = match env::var_os("OUT_DIR") {
+///     None => return Ok(()),
+///     Some(outdir) => outdir,
+/// };
 ///
-///     let mut cmd = build_cli();
-///     let path = generate_to(
-///         Bash,
-///         &mut cmd, // We need to specify what generator to use
-///         "myapp",  // We need to specify the bin name manually
-///         outdir,   // We need to specify where to write to
-///     )?;
+/// let mut cmd = build_cli();
+/// let path = generate_to(
+///     Bash,
+///     &mut cmd, // We need to specify what generator to use
+///     "myapp",  // We need to specify the bin name manually
+///     outdir,   // We need to specify where to write to
+/// )?;
 ///
-///     println!("cargo:warning=completion file is generated: {path:?}");
+/// println!("cargo:warning=completion file is generated: {path:?}");
 ///
-///     Ok(())
-/// }
+/// Ok(())
 /// ```
 ///
 /// Now, once we compile there will be a `{bin_name}.bash` file in the directory.
@@ -218,19 +214,17 @@ pub trait Generator {
 ///
 /// include!("src/cli.rs");
 ///
-/// fn main() -> Result<(), Error> {
-///     let outdir = match env::var_os("OUT_DIR") {
-///         None => return Ok(()),
-///         Some(outdir) => outdir,
-///     };
-///
-///     let mut cmd = build_cli();
-///     for &shell in Shell::value_variants() {
-///         generate_to(shell, &mut cmd, "myapp", outdir)?;
-///     }
+/// let outdir = match env::var_os("OUT_DIR") {
+///     None => return Ok(()),
+///     Some(outdir) => outdir,
+/// };
 ///
-///     Ok(())
+/// let mut cmd = build_cli();
+/// for &shell in Shell::value_variants() {
+///     generate_to(shell, &mut cmd, "myapp", outdir)?;
 /// }
+///
+/// Ok(())
 /// ```
 pub fn generate_to<G, S, T>(
     generator: G,
@@ -273,16 +267,13 @@ where
 /// use std::io;
 /// use clap_complete::{generate, shells::Bash};
 ///
-/// fn main() {
-///     let matches = cli::build_cli().get_matches();
-///
-///     if matches.is_present("generate-bash-completions") {
-///         generate(Bash, &mut cli::build_cli(), "myapp", &mut io::stdout());
-///     }
+/// let matches = cli::build_cli().get_matches();
 ///
-///     // normal logic continues...
+/// if matches.is_present("generate-bash-completions") {
+///     generate(Bash, &mut cli::build_cli(), "myapp", &mut io::stdout());
 /// }
 ///
+/// // normal logic continues...
 /// ```
 ///
 /// Usage:

clap_complete/src/aot/mod.rs

@@ -37,14 +37,12 @@
 //!     generate(generator, cmd, cmd.get_name().to_string(), &mut io::stdout());
 //! }
 //!
-//! fn main() {
-//!     let matches = build_cli().get_matches();
-//!
-//!     if let Some(generator) = matches.get_one::<Shell>("generator").copied() {
-//!         let mut cmd = build_cli();
-//!         eprintln!("Generating completion file for {generator}...");
-//!         print_completions(generator, &mut cmd);
-//!     }
+//! let matches = build_cli().get_matches();
+//!
+//! if let Some(generator) = matches.get_one::<Shell>("generator").copied() {
+//!     let mut cmd = build_cli();
+//!     eprintln!("Generating completion file for {generator}...");
+//!     print_completions(generator, &mut cmd);
 //! }
 //! ```
 

clap_complete/src/env/mod.rs

@@ -8,12 +8,10 @@
 //! #   clap::Command::new("empty")
 //! }
 //!
-//! fn main() {
-//!     CompleteEnv::with_factory(cli)
-//!         .complete();
+//! CompleteEnv::with_factory(cli)
+//!     .complete();
 //!
-//!     // ... rest of application logic
-//! }
+//! // ... rest of application logic
 //! ```
 //!
 //! To customize completions, see
@@ -92,12 +90,10 @@ pub use shells::*;
 /// #   clap::Command::new("empty")
 /// }
 ///
-/// fn main() {
-///     CompleteEnv::with_factory(cli)
-///         .complete()
+/// CompleteEnv::with_factory(cli)
+///     .complete()
 ///
-///     // ... rest of application logic
-/// }
+/// // ... rest of application logic
 /// ```
 pub struct CompleteEnv<'s, F> {
     factory: F,
@@ -120,12 +116,10 @@ impl<'s, F: Fn() -> clap::Command> CompleteEnv<'s, F> {
     /// #   clap::Command::new("empty")
     /// }
     ///
-    /// fn main() {
-    ///     CompleteEnv::with_factory(cli)
-    ///         .complete()
+    /// CompleteEnv::with_factory(cli)
+    ///     .complete()
     ///
-    ///     // ... rest of application logic
-    /// }
+    /// // ... rest of application logic
     /// ```
     ///
     /// Derive:
@@ -139,12 +133,10 @@ impl<'s, F: Fn() -> clap::Command> CompleteEnv<'s, F> {
     ///     custom: Option<String>,
     /// }
     ///
-    /// fn main() {
-    ///     CompleteEnv::with_factory(Cli::command)
-    ///         .complete()
+    /// CompleteEnv::with_factory(Cli::command)
+    ///     .complete()
     ///
-    ///     // ... rest of application logic
-    /// }
+    /// // ... rest of application logic
     /// ```
     pub fn with_factory(factory: F) -> Self {
         Self {

clap_complete/src/lib.rs

@@ -35,14 +35,12 @@
 //!     generate(generator, cmd, cmd.get_name().to_string(), &mut io::stdout());
 //! }
 //!
-//! fn main() {
-//!     let matches = build_cli().get_matches();
+//! let matches = build_cli().get_matches();
 //!
-//!     if let Some(generator) = matches.get_one::<Shell>("generator").copied() {
-//!         let mut cmd = build_cli();
-//!         eprintln!("Generating completion file for {generator}...");
-//!         print_completions(generator, &mut cmd);
-//!     }
+//! if let Some(generator) = matches.get_one::<Shell>("generator").copied() {
+//!     let mut cmd = build_cli();
+//!     eprintln!("Generating completion file for {generator}...");
+//!     print_completions(generator, &mut cmd);
 //! }
 //! ```
 

src/_derive/mod.rs

@@ -81,9 +81,7 @@
 //!     Variant1,
 //! }
 //!
-//! fn main() {
-//!     let cli = Cli::parse();
-//! }
+//! let cli = Cli::parse();
 //! ```
 //!
 //! Traits: