[[chef-dev]] Package provider docs - upgrade clarification

[Matthew Kent < >]

Hello!

Looking for some clarification on documentation of the package
resource @ http://wiki.opscode.com/display/chef/Resources#Resources-Package

Docs say "Upgrade a package - if version is provided, upgrade to that
specific version" but looking at the code in provider/package.rb I
can't see a specific version being passed to upgrade_package, only the
candidate_version. Is this the correct behavior? Should an upgrade
with a specific version just call action_install?

This has caused confusion at least once here
http://tickets.opscode.com/browse/CHEF-1195

For now am I okay to change the docs to "Upgrade a package if a newer
version is available" ?