Update help message comments. Closes #517

src/command_line.rs

@@ -12,40 +12,42 @@ use serde::Serialize;
 #[derive(Debug, Default, Parser)]
 #[command(rename_all = "kebab-case")]
 pub struct SliceOptions {
-    /// List of slice files to compile.
+    /// List of Slice files to compile.
     #[arg(required = true)]
     pub sources: Vec<String>,
 
-    /// Files that are needed for referencing, but that no code should be generated for.
-    #[arg(short = 'R', long, num_args = 1, action = Append)]
+    /// Reference Slice file or directory containing Slice files. Reference files are used to resolve definitions in
+    /// the Slice sources being compiled. Directories are searched recursively. This option can be repeated.
+    #[arg(short = 'R', long = "reference", num_args = 1, action = Append)]
     pub references: Vec<String>,
 
-    /// Preprocessor Symbols defined on the command line.
-    #[arg(short = 'D', long, num_args = 1, action = Append)]
+    /// Define a preprocessor definition. Preprocessor definitions do not have an associated value.
+    /// This option can be repeated.
+    #[arg(short = 'D', long = "define", num_args = 1, action = Append)]
     pub definitions: Vec<String>,
 
-    /// Instructs the compiler to treat warnings as errors.
+    /// Instruct the compiler to treat warnings as errors.
     #[arg(short, long)]
     pub warn_as_error: bool,
 
-    /// Instructs the compiler to allow warnings. Specify a list of warnings to allow, or leave empty to allow all
-    /// warnings.
-    #[arg(long)]
-    pub allow_warnings: Option<Vec<String>>,
+    /// Instruct the compiler to allow the specified warning. An allowed warning will not be emitted as a
+    /// diagnostic. This option can be repeated.
+    #[arg(short = 'A', long = "allow")]
+    pub allowed_warnings: Option<Vec<String>>,
 
-    /// Validates input files without generating code for them.
+    /// Validate input files without generating code for them.
     #[arg(long)]
     pub dry_run: bool,
 
-    /// Output directory for generated code, defaults to the current working directory.
+    /// Set the output directory for the generated code, defaults to the current working directory.
     #[arg(long)]
     pub output_dir: Option<String>,
 
     /// Output format for emitted errors.
     #[arg(value_enum, default_value_t = DiagnosticFormat::Human, long, ignore_case = true)]
     pub diagnostic_format: DiagnosticFormat,
 
-    /// Disables ANSI escape code for diagnostic output.
+    /// Disable ANSI escape code for diagnostic output.
     #[arg(long)]
     pub disable_color: bool,
 }

src/diagnostics/diagnostic_reporter.rs

@@ -39,7 +39,7 @@ impl DiagnosticReporter {
             treat_warnings_as_errors: slice_options.warn_as_error,
             diagnostic_format: slice_options.diagnostic_format,
             disable_color: slice_options.disable_color,
-            allowed_warnings: slice_options.allow_warnings.clone(),
+            allowed_warnings: slice_options.allowed_warnings.clone(),
         }
     }
 

tests/diagnostic_output_tests.rs

@@ -120,7 +120,7 @@ error [E010]: invalid enum 'E': enums must contain at least one enumerator
         // Set the output format to JSON.
         let options = SliceOptions {
             diagnostic_format: DiagnosticFormat::Json,
-            allow_warnings: Some(vec![]),
+            allowed_warnings: Some(vec![]),
             ..Default::default()
         };
 
@@ -151,7 +151,7 @@ error [E010]: invalid enum 'E': enums must contain at least one enumerator
         // Set the output format to JSON.
         let options = SliceOptions {
             diagnostic_format: DiagnosticFormat::Json,
-            allow_warnings: Some(vec!["W004".to_string()]),
+            allowed_warnings: Some(vec!["W004".to_string()]),
             ..Default::default()
         };