'cf help' should show 'unset-env' command

[tjarratt]

Command

cf help

What occurred

It prints a few things, but not 'unset-env'

What you expected to occur

It should totally print this command, because I forgot how to do it.

CLI Version

cf version 6.28.0+9e024bdbd.2017-06-27

[cf-gitbot]

We have created an issue in Pivotal Tracker to manage this:

https://www.pivotaltracker.com/story/show/148570729

The labels on this github issue will be updated when the story is started.

[dkoper]

Hi @tjarratt

We intentionally don't display all commands. You probably remember what help looked like a year ago, several pages of text scrolling over the screen and without grep it was impossible to find anything fast.

We addressed that by reducing cf help to only show the most commonly used app developer commands. The rest is available under cf help -a.

I image you would agree that in general set-env is used more than unset-env, just like push is used more than delete and run-task more than terminate-task. That is why we left unset-env out and are able to keep cf help to a concise list of no more than a single page.

Regards,
Dies Koper
CF CLI PM

[tjarratt]

Ah, I see, that makes a lot of sense to me. It's still a little hard to find, for clarity this was the commands I had to run in order to find the unset-env command (over the course of about 3-5 minutes).

cf help # not there
cf help set-env # not there
cf help all # whoops !
cf help --all # whoops!
cf --help # okay, now I've found it

Would it be possible to maybe add a note to the help page for set-env that unset-env exists ? Maybe something like "See Also: unset-env". That would greatly increase the ability for me to remember how to find that command's help.

[dkoper]

We can look into that.
But if the first command you ran was cf help, which displays These are commonly used commands. Use 'cf help -a' to see all, with descriptions. at the end, which I assume you missed, would you have picked up anything at the end of cf help set-env?

[dkoper]

We have added unset-env to set-env's SEE ALSO in cf CLI 6.29.0.