Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

(#2641) Add deprecation messages for shims #2643

Conversation

AdmiringWorm
Copy link
Member

@AdmiringWorm AdmiringWorm commented Mar 10, 2022

Description Of Changes

This pull request updates the help text and documentation around the commands to mention that the shims we have available is now deprecated and will be removed in v2.0.0.
Additionally, a missed location mentioning that the search command is an alias for list is removed as these will be considered two seperate commands in v2.0.0.

Motivation and Context

To do our best to give users the information needed for future usage of the Chocolatey executable.

Testing

  1. Run choco -? and notice there is a deprecation warning about shims going away.
  2. Run choco install -? and a mention of the shim cinst is deprecated will be shown.
  3. Run choco list -? and the same mention is shown
  4. Run choco search -? and notice there are no deprecation notice about the shim, however there is a notice in the example of it.
  5. Run choco push -? and the same deprecation notice should be shown.
  6. Run choco uninstall -? and the same here.
  7. Run choco upgrade -? and this is also the same.
  8. Generate the documentation using GenerateDocs, and verify all commands have a warning that the shims are deprecated and will be removed.

Change Types Made

  • Bug fix (non-breaking change)
  • Feature / Enhancement (non-breaking change)
  • Breaking change (fix or feature that could cause existing functionality to change)
  • PowerShell code changes.
  • Documentation

Related Issue

fixes #2641
Small change for #2462
https://app.clickup.com/t/20540031/ENGTASKS-723

Change Checklist

  • Requires a change to the documentation
  • Documentation has been updated
  • Tests to cover my changes, have been added
  • All new and existing tests passed.
  • PowerShell v2 compatibility checked.

This commit updates the help text for relevant commands
to mention that their shims will be removed in v2.0.0
This commit updates the generate docs helper to add
a global warning for all commands mentioning that shims
will be removed in v2.0.0. It also mentions which shims will
be removed, and their full use.
This commit updates the whitespace and formatting
for files touched to be consistent.
This commit updates the registration for the search
command/alias to no longer mention it being an alias
for the search command.

This is done so it will look like that list and search
is not the same handler, as the list command itself will
be made local only in v2.0.0

This was somehow missed when deprecating the remote arguments
when list is called
@AdmiringWorm AdmiringWorm self-assigned this Mar 10, 2022
@AdmiringWorm AdmiringWorm requested a review from gep13 March 10, 2022 12:35
Copy link
Member

@gep13 gep13 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

@gep13 gep13 merged commit 3fd8c10 into chocolatey:develop Mar 10, 2022
@gep13
Copy link
Member

gep13 commented Mar 10, 2022

@AdmiringWorm thanks for getting this added!

@AdmiringWorm AdmiringWorm deleted the 2641-Mark-Chocolatey-shims-chocolatey-cinst-clist-cpush-cuninst-cup-are-deprecated branch March 11, 2022 10:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Mark Chocolatey shims (chocolatey. cinst, clist, cpush, cuninst, cup) as deprecated
2 participants