Touch up some documentation around commands

src/bin/cargo-build.rs

@@ -37,7 +37,7 @@ fn main() {
 }
 
 fn execute(options: Options, shell: &mut MultiShell) -> CliResult<Option<()>> {
-    debug!("executing; cmd=cargo-compile; args={}", os::args());
+    debug!("executing; cmd=cargo-build; args={}", os::args());
     shell.set_verbose(options.flag_verbose);
 
     let root = try!(find_root_manifest_for_cwd(options.flag_manifest_path));

src/bin/cargo-clean.rs

@@ -15,12 +15,14 @@ use cargo::util::{CliResult, CliError};
 use cargo::util::important_paths::{find_root_manifest_for_cwd};
 
 docopt!(Options, "
+Remove artifacts that cargo has generated in the past
+
 Usage:
     cargo-clean [options]
 
 Options:
     -h, --help              Print this message
-    --manifest-path PATH    Path to the manifest to compile
+    --manifest-path PATH    Path to the manifest to the package to clean
     -v, --verbose           Use verbose output
 ",  flag_manifest_path: Option<String>)
 

src/bin/cargo-doc.rs

@@ -24,7 +24,7 @@ Options:
     --no-deps               Don't build documentation for dependencies
     -j N, --jobs N          The number of jobs to run in parallel
     -u, --update-remotes    Update all remote packages before compiling
-    --manifest-path PATH    Path to the manifest to compile
+    --manifest-path PATH    Path to the manifest to document
     -v, --verbose           Use verbose output
 
 By default the documentation for the local package and all dependencies is

src/bin/cargo-generate-lockfile.rs

@@ -21,10 +21,8 @@ Usage:
 
 Options:
     -h, --help              Print this message
-    --manifest-path PATH    Path to the manifest to compile
+    --manifest-path PATH    Path to the manifest to generate a lockfile for
     -v, --verbose           Use verbose output
-
-All of the trailing arguments are passed as to the binary to run.
 ",  flag_manifest_path: Option<String>)
 
 fn main() {
@@ -32,7 +30,7 @@ fn main() {
 }
 
 fn execute(options: Options, shell: &mut MultiShell) -> CliResult<Option<()>> {
-    debug!("executing; cmd=cargo-clean; args={}", os::args());
+    debug!("executing; cmd=cargo-generate-lockfile; args={}", os::args());
     shell.set_verbose(options.flag_verbose);
     let root = try!(find_root_manifest_for_cwd(options.flag_manifest_path));
 

src/bin/cargo-run.rs

@@ -23,7 +23,7 @@ Options:
     -h, --help              Print this message
     -j N, --jobs N          The number of jobs to run in parallel
     -u, --update-remotes    Update all remote packages before compiling
-    --manifest-path PATH    Path to the manifest to compile
+    --manifest-path PATH    Path to the manifest to execute
     -v, --verbose           Use verbose output
 
 All of the trailing arguments are passed as to the binary to run.

src/bin/cargo-test.rs

@@ -24,7 +24,7 @@ Options:
     -h, --help              Print this message
     -j N, --jobs N          The number of jobs to run in parallel
     -u, --update-remotes    Update all remote packages before compiling
-    --manifest-path PATH    Path to the manifest to compile
+    --manifest-path PATH    Path to the manifest to build tests for
     -v, --verbose           Use verbose output
 
 All of the trailing arguments are passed to the test binaries generated for