Command line arguments example is unclear about just HOT 6 CLOSED

Running just by itself gives me this output:

just <cmd> [options]

Tasks:

  just blimey  An exclamation of surprise.

Options:
  --version  Show version number                                       [boolean]
  --config   path to a just-task.js file (includes the file name)
  --name
  --help     Show help                                                 [boolean]

No default tasks are defined.
[12:28:13 PM] x Error previously detected. See above for error messages.

Should we update the docs to reflect this? Or should we do code changes to have just --help have the same output as just.

Also, what do we expect just blimey --help to return? I believe it should return a description for blimey as well as the options that it accepts. However, with the current API, there's no way to associate an option with a task.

@kenotron thoughts?

from just.

As far as the optimal behaviour is concerned it should print the helping message when passed with --help flag. I guess its an issue !....

from just.

just on it's own indeed prints everything.
just with --help however doesn't neither does just taskname --help

I will take more time to look at this on Sunday at the earliest, but seems like a good issue to get familiar with yargs and just : ) So feel free to tweak the finding

from just.

I guess the options are a wrapper for yargs. If it so then just check if anything missing in the yargs implementation. Cause yargs should take care of command --help flag

from just.

Show help is not very much help at the moment for the options it seems. I mainly did as much as possible to list

Running just by itself gives me this output:

just <cmd> [options]

Tasks:

  just blimey  An exclamation of surprise.

Options:
  --version  Show version number                                       [boolean]
  --config   path to a just-task.js file (includes the file name)
  --name
  --help     Show help                                                 [boolean]

No default tasks are defined.
[12:28:13 PM] x Error previously detected. See above for error messages.

Should we update the docs to reflect this? Or should we do code changes to have just --help have the same output as just.

Also, what do we expect just blimey --help to return? I believe it should return a description for blimey as well as the options that it accepts. However, with the current API, there's no way to associate an option with a task.

@kenotron Ken Chau FTE thoughts?

The issue here is that options and tasks are defined all in one. That's actually how it would work elsewhere. In a just.config.js that has multiple tasks defined and multiple options, you could actually run any of the tasks with any of the options. This means that options aren't really tied to a task. All options are essentially global.

I really think the help message should include all options and all tasks like when you run just by itself. This is a bug - probably because I'm using yargs in a way that's not how it's directly designed to do. I'm considering switching to yargs-parser and handle command and help inside just-task itself.

from just.

Issues seem to have gone stale.

from just.