chore(cmds): Improve command descriptions

Author: jcs090218

cmds/core/install-vc.js

@@ -18,7 +18,7 @@
 "use strict";
 
 exports.command = ['install-vc [specs..]'];
-exports.desc = 'Install packages directly from the version control';
+exports.desc = 'Fetch and install packages directly via version control';
 exports.builder = yargs => yargs
   .positional(
     '[specs..]', {

cmds/core/install.js

@@ -18,7 +18,7 @@
 "use strict";
 
 exports.command = ['install [names..]'];
-exports.desc = 'Install packages';
+exports.desc = 'Install packages from archives or install from the workspace';
 exports.builder = yargs => yargs
   .positional(
     '[names..]', {

cmds/core/keywords.js

@@ -18,7 +18,7 @@
 "use strict";
 
 exports.command = ['keywords'];
-exports.desc = 'List available keywords that can be used in the header section';
+exports.desc = 'Display the available keywords for use in the header section';
 
 exports.handler = async (argv) => {
   await UTIL.e_call(argv, 'core/keywords');

cmds/core/package-directory.js

@@ -18,7 +18,7 @@
 "use strict";
 
 exports.command = ['package-directory'];
-exports.desc = 'Print path to package directory';
+exports.desc = 'Print the path to package directory';
 
 exports.handler = async (argv) => {
   await UTIL.e_call(argv, 'core/package-directory');

cmds/core/refresh.js

@@ -18,7 +18,7 @@
 "use strict";
 
 exports.command = ['refresh'];
-exports.desc = 'Download package archives';
+exports.desc = 'Download descriptions of all configured package archives';
 
 exports.handler = async (argv) => {
   await UTIL.e_call(argv, 'core/refresh');

cmds/core/reinstall.js

@@ -18,7 +18,7 @@
 "use strict";
 
 exports.command = ['reinstall [names..]'];
-exports.desc = 'Reinstall packages';
+exports.desc = 'Reinstall packages from archives';
 exports.builder = yargs => yargs
   .positional(
     '[names..]', {

cmds/core/repl.js

@@ -18,7 +18,7 @@
 "use strict";
 
 exports.command = ['repl', 'ielm'];
-exports.desc = UTIL.hide_cmd('Start the Elisp REPL');
+exports.desc = UTIL.hide_cmd('Start an Elisp REPL');
 
 exports.handler = async (argv) => {
   await UTIL.e_call(argv, 'core/repl');

cmds/core/search.js

@@ -18,7 +18,7 @@
 "use strict";
 
 exports.command = ['search [queries..]'];
-exports.desc = 'Search packages';
+exports.desc = 'Search packages from archives';
 exports.builder = yargs => yargs
   .positional(
     '[queries..]', {

cmds/core/source.js

@@ -18,7 +18,7 @@
 "use strict";
 
 exports.command = ['source <type>'];
-exports.desc = UTIL.hide_cmd('Add/Remove source from DSL');
+exports.desc = UTIL.hide_cmd('Manage sources');
 exports.builder = function (yargs) {
   yargs.usage(`${exports.desc}
 
@@ -30,8 +30,8 @@ Usage: eask source <type> [options..]`)
   if (UTIL.cmd_count() == 1) {
     yargs.positional(
       '<type>', {
-      description: 'type of the control',
-    });
+        description: 'type of the control',
+      });
   }
 }
 

cmds/core/status.js

@@ -18,7 +18,7 @@
 "use strict";
 
 exports.command = ['status'];
-exports.desc = 'Display the state of the workspace';
+exports.desc = 'Show the workspace status';
 
 exports.handler = async (argv) => {
   await UTIL.e_call(argv, 'core/status');