docs(tutorial): Focus on actions, not macros

examples/tutorial_builder/03_01_flag_count.rs

@@ -1,8 +1,13 @@
-use clap::{arg, command, ArgAction};
+use clap::{command, Arg, ArgAction};
 
 fn main() {
     let matches = command!() // requires `cargo` feature
-        .arg(arg!(-v - -verbose).action(ArgAction::Count))
+        .arg(
+            Arg::new("verbose")
+                .short('v')
+                .long("verbose")
+                .action(ArgAction::Count),
+        )
         .get_matches();
 
     println!(

examples/tutorial_builder/03_02_option.md

@@ -7,7 +7,7 @@ USAGE:
     03_02_option[EXE] [OPTIONS]
 
 OPTIONS:
-    -n, --name <NAME>    
+    -n, --name <name>    
     -h, --help           Print help information
     -V, --version        Print version information
 

examples/tutorial_builder/03_02_option.rs

@@ -1,8 +1,8 @@
-use clap::{arg, command};
+use clap::{command, Arg};
 
 fn main() {
     let matches = command!() // requires `cargo` feature
-        .arg(arg!(-n --name <NAME>).required(false))
+        .arg(Arg::new("name").short('n').long("name"))
         .get_matches();
 
     println!("name: {:?}", matches.get_one::<String>("name"));

examples/tutorial_builder/03_03_positional.md

@@ -4,19 +4,19 @@ clap [..]
 A simple to use, efficient, and full-featured Command Line Argument Parser
 
 USAGE:
-    03_03_positional[EXE] [NAME]
+    03_03_positional[EXE] [name]
 
 ARGS:
-    <NAME>    
+    <name>    
 
 OPTIONS:
     -h, --help       Print help information
     -V, --version    Print version information
 
 $ 03_03_positional
-NAME: None
+name: None
 
 $ 03_03_positional bob
-NAME: Some("bob")
+name: Some("bob")
 
 ```

examples/tutorial_builder/03_03_positional.rs

@@ -1,9 +1,9 @@
-use clap::{arg, command};
+use clap::{command, Arg};
 
 fn main() {
     let matches = command!() // requires `cargo` feature
-        .arg(arg!([NAME]))
+        .arg(Arg::new("name"))
         .get_matches();
 
-    println!("NAME: {:?}", matches.get_one::<String>("NAME"));
+    println!("name: {:?}", matches.get_one::<String>("name"));
 }

examples/tutorial_builder/03_05_default_values.md

@@ -14,9 +14,9 @@ OPTIONS:
     -V, --version    Print version information
 
 $ 03_05_default_values
-NAME: "alice"
+name: "alice"
 
 $ 03_05_default_values bob
-NAME: "bob"
+name: "bob"
 
 ```

examples/tutorial_builder/03_05_default_values.rs

@@ -6,7 +6,7 @@ fn main() {
         .get_matches();
 
     println!(
-        "NAME: {:?}",
+        "name: {:?}",
         matches
             .get_one::<String>("NAME")
             .expect("default ensures there is always a value")