search

chocolatey-archive / chocolatey

[DEPRECATED - https://github.com/chocolatey/choco] Chocolatey NuGet - Like apt-get, but for windows.
https://chocolatey.org
Apache License 2.0
2.8k stars 344 forks source link

Friendlier way to get command help #388

Open codearoo opened 10 years ago

codearoo commented 10 years ago

All choco "alias" commands should accept the typical parameters to request for help, or in the very least, guide the user to type "choco --help" or something.

C:\software>cup /? Chocolatey (v0.9.8.23) is installing '/?' and dependencies. By installing you ac cept the license for '/?' and each dependency you are installing. Finished installing '/?' and dependencies - if errors not shown in console, none detected. Check log for errors if unsure. Reading environment variables from registry. Please wait... Done.

C:\software>cup --help Unknown option: '--help' Chocolatey (v0.9.8.23) is installing '--help' and dependencies. By installing yo u accept the license for '--help' and each dependency you are installing. Unknown option: '--help'

Command 'update' failed (sometimes this indicates a partial failure). Additional info/packages: --help Reading environment variables from registry. Please wait... Done.

C:\software>cup -help Chocolatey (v0.9.8.23) is installing '-help' and dependencies. By installing you accept the license for '-help' and each dependency you are installing. Finished installing '-help' and dependencies - if errors not shown in console, n one detected. Check log for errors if unsure. Reading environment variables from registry. Please wait... Done.

ferventcoder commented 10 years ago

Sad...that's sad to look at. This happens because you are using the alias which is passing install or update to choco.

So what this means is we should either remove all aliases or search for those strings and do replacement. I'm in favor of deprecation of shortcuts.

codearoo commented 10 years ago

AMEN! no shortcuts! :)

"chocolatey" might have been a pain to type (and spell) but: "choco" is very nice!

choco install choco update choco update all choco uninstall etc.

Then it's actually much more like 'apt-get'

codearoo commented 10 years ago

As a transition phase... the 'cinst' and other aliases could just output to the screen instead:

"Please run choco install instead"

ferventcoder commented 10 years ago

Note that this is the transition phase... it has already begun. :)

ferventcoder commented 10 years ago

choco is the ubiquitous term. It beat the rest of the possibilities...

codearoo commented 10 years ago

To speed up this process, you may want to do a "replace all" on your website.. where each package that displays the big:

c:> cinst chocolatey

to now be:

c:> choco install chocolatey

You even have images on the home page using 'cinst'

ferventcoder commented 10 years ago

The first is not a replace all, it's just a one line change. https://github.com/chocolatey/chocolatey.org/blob/master/chocolatey/Website/Views/Packages/DisplayPackage.cshtml#L98

The second is a change to an image.

codearoo commented 10 years ago

sweet. what are you waiting for? :) (the 1 liner anyway) haha

Remembering that SOFTware should not be HARD.. it is SOFT so be bold. :)

codearoo commented 10 years ago

I'm already updating my scripts to use 'choco install'