add some comments to clarify command-line argument munging in #482

Author: apoelstra

src/bin/cargo-miri.rs

@@ -99,6 +99,7 @@ fn main() {
             );
             match (test, &kind[..]) {
                 (true, "test") => {
+                    // For test binaries we call `cargo rustc --test target -- <rustc args>`
                     if let Err(code) = process(
                         vec!["--test".to_string(), target.name].into_iter().chain(
                             args,
@@ -109,6 +110,8 @@ fn main() {
                     }
                 }
                 (true, "lib") => {
+                    // For libraries we call `cargo rustc -- --test <rustc args>`
+                    // Notice now that `--test` is a rustc arg rather than a cargo arg.
                     if let Err(code) = process(
                         vec!["--".to_string(), "--test".to_string()].into_iter().chain(
                             args,
@@ -119,6 +122,7 @@ fn main() {
                     }
                 }
                 (false, "bin") => {
+                    // For ordinary binaries we call `cargo rustc --bin target -- <rustc args>`
                     if let Err(code) = process(
                         vec!["--bin".to_string(), target.name].into_iter().chain(
                             args,