Make runner arg descriptions more consistent

src/runner.ts

@@ -79,16 +79,16 @@ interface InitArgs {
 program
   .command('init')
   .description('Initializes CodeQL')
-  .requiredOption('--repository <repository>', 'Repository name')
-  .requiredOption('--github-url <url>', 'URL of GitHub instance')
-  .requiredOption('--github-auth <auth>', 'GitHub Apps token or personal access token')
-  .option('--languages <languages>', 'Comma-separated list of languages to analyze. Defaults to trying to detect languages from the repo.')
-  .option('--queries <queries>', 'Comma-separated list of additional queries to run. By default, this overrides the same setting in a configuration file.')
-  .option('--config-file <file>', 'Path to config file')
+  .requiredOption('--repository <repository>', 'Repository name. (Required)')
+  .requiredOption('--github-url <url>', 'URL of GitHub instance. (Required)')
+  .requiredOption('--github-auth <auth>', 'GitHub Apps token or personal access token. (Required)')
+  .option('--languages <languages>', 'Comma-separated list of languages to analyze. Otherwise detects and analyzes all supported languages from the repo.')
+  .option('--queries <queries>', 'Comma-separated list of additional queries to run. This overrides the same setting in a configuration file.')
+  .option('--config-file <file>', 'Path to config file.')
   .option('--codeql-path <path>', 'Path to a copy of the CodeQL CLI executable to use. Otherwise downloads a copy.')
-  .option('--temp-dir <dir>', 'Directory to use for temporary files. By default will use "./codeql-runner".')
-  .option('--tools-dir <dir>', 'Directory to use for CodeQL tools and other files to store between runs. By default will use home directory.')
-  .option('--checkout-path <path>', 'Checkout path (default: current working directory)')
+  .option('--temp-dir <dir>', 'Directory to use for temporary files. Default is "./codeql-runner".')
+  .option('--tools-dir <dir>', 'Directory to use for CodeQL tools and other files to store between runs. Default is a subdirectory of the home directory.')
+  .option('--checkout-path <path>', 'Checkout path. Default is the current working directory.')
   .option('--debug', 'Print more verbose output', false)
   .action(async (cmd: InitArgs) => {
     const logger = getRunnerLogger(cmd.debug);
@@ -181,8 +181,8 @@ interface AutobuildArgs {
 program
   .command('autobuild')
   .description('Attempts to automatically build code')
-  .option('--language <language>', 'The language to build. By default will try to detect the dominant language.')
-  .option('--temp-dir <dir>', 'Directory to use for temporary files. By default will use "./codeql-runner".')
+  .option('--language <language>', 'The language to build. Otherwise will detect the dominant compiled language.')
+  .option('--temp-dir <dir>', 'Directory to use for temporary files. Default is "./codeql-runner".')
   .option('--debug', 'Print more verbose output', false)
   .action(async (cmd: AutobuildArgs) => {
     const logger = getRunnerLogger(cmd.debug);
@@ -225,15 +225,15 @@ interface AnalyzeArgs {
 program
   .command('analyze')
   .description('Finishes extracting code and runs CodeQL queries')
-  .requiredOption('--repository <repository>', 'Repository name')
-  .requiredOption('--commit <commit>', 'SHA of commit that was analyzed')
-  .requiredOption('--ref <ref>', 'Name of ref that was analyzed')
-  .requiredOption('--github-url <url>', 'URL of GitHub instance')
-  .requiredOption('--github-auth <auth>', 'GitHub Apps token, or of the form "username:token" if using a personal access token')
-  .option('--checkout-path <path>', 'Checkout path (default: current working directory)')
-  .option('--no-upload', 'Do not upload results after analysis', false)
-  .option('--output-dir <dir>', 'Directory to output SARIF files to. By default will use temp directory.')
-  .option('--temp-dir <dir>', 'Directory to use for temporary files. By default will use "./codeql-runner".')
+  .requiredOption('--repository <repository>', 'Repository name. (Required)')
+  .requiredOption('--commit <commit>', 'SHA of commit that was analyzed. (Required)')
+  .requiredOption('--ref <ref>', 'Name of ref that was analyzed. (Required)')
+  .requiredOption('--github-url <url>', 'URL of GitHub instance. (Required)')
+  .requiredOption('--github-auth <auth>', 'GitHub Apps token or personal access token. (Required)')
+  .option('--checkout-path <path>', 'Checkout path. Default is the current working directory.')
+  .option('--no-upload', 'Do not upload results after analysis.', false)
+  .option('--output-dir <dir>', 'Directory to output SARIF files to. Default is in the temp directory.')
+  .option('--temp-dir <dir>', 'Directory to use for temporary files. Default is "./codeql-runner".')
   .option('--debug', 'Print more verbose output', false)
   .action(async (cmd: AnalyzeArgs) => {
     const logger = getRunnerLogger(cmd.debug);
@@ -279,13 +279,13 @@ interface UploadArgs {
 program
   .command('upload')
   .description('Uploads a SARIF file, or all SARIF files from a directory, to code scanning')
-  .requiredOption('--sarif-file <file>', 'SARIF file to upload; can also be a directory for uploading multiple')
-  .requiredOption('--repository <repository>', 'Repository name')
-  .requiredOption('--commit <commit>', 'SHA of commit that was analyzed')
-  .requiredOption('--ref <ref>', 'Name of ref that was analyzed')
-  .requiredOption('--github-url <url>', 'URL of GitHub instance')
-  .requiredOption('--github-auth <auth>', 'GitHub Apps token, or of the form "username:token" if using a personal access token')
-  .option('--checkout-path <path>', 'Checkout path (default: current working directory)')
+  .requiredOption('--sarif-file <file>', 'SARIF file to upload, or a directory containing multiple SARIF files. (Required)')
+  .requiredOption('--repository <repository>', 'Repository name. (Required)')
+  .requiredOption('--commit <commit>', 'SHA of commit that was analyzed. (Required)')
+  .requiredOption('--ref <ref>', 'Name of ref that was analyzed. (Required)')
+  .requiredOption('--github-url <url>', 'URL of GitHub instance. (Required)')
+  .requiredOption('--github-auth <auth>', 'GitHub Apps token or personal access token. (Required)')
+  .option('--checkout-path <path>', 'Checkout path. Default is the current working directory.')
   .option('--debug', 'Print more verbose output', false)
   .action(async (cmd: UploadArgs) => {
     const logger = getRunnerLogger(cmd.debug);