Deprecation of command

[ibilon]

Following #283 (comment)

I think these three commands should be deprecated:

• selfupdate
• local
• either update or upgrade (and update the help message of the other)

Deprecation would mean to hide them from the help and show a notice when running them:
Warning: this command is deprecated, use "$replacement" instead, and will be removed in a later version.

Here $replacement would be (respectively):

• haxelib update haxelib_client
• haxelib install file.zip
• either haxelib upgrade library or haxelib update

And the later version would most likely be the one released with haxe 4.

And while we are on the topic of hiding things I don't think we should show the entire help when haxelib is run without arguments, only the common things.

Things like: config, path, convertxml, newrepo, deleterepo, proxy, all flags but always could only appear when doing haxelib help.
With that and the deprecated command the output would go from the currently long 38 lines to 25.

[nadako]

Note that upgrade and update commands were unified in bfcd9ca and I think we can keep it this way, it's just handy not to care whether you type update or upgrade.

[nadako]

Agree on the other two, no opinion about help :)

[ibilon]

In that case we could at least hide one and change the help of the other?

[nadako]

Not sure I understand you now :) upgrade is already hidden, for others what you propose seems good: emit a warning, maybe add a [DEPRECATED] tag to their description.

[ibilon]

Of course if I look at the old haxelib and not the dev version :)

I'd hide the deprecated from the help, that way the people who don't know about them wouldn't start using them.

[nadako]

Agreed!

[Simn]

Agreed as well!

[nadako]

I added a deprecation method in the referenced commit, we'll use it for selfupdate when it becomes redundant.

[nadako]

At some point we'll need to implement proper help system for our commands, so user can get to know that e.g. they can use install in various ways. But let's not focus on it right now and implement it when we'll be finally refactoring the codebase.