[Bug 1700829] Re: -d switch isn't accurately described

[Brian Murray]

** Description changed:

- The -d switch for update-manager is documented as 'Check if upgrading to
- the latest devel release is possible'.  This implies that no matter what
- release you are running the -d switch check if you can upgrade to the
- devel release (Artful right now) however, this isn't actually what the
- -d switch does. Right now the -d switch will take you to the next
- unsupported release of Ubuntu, so in a few weeks will upgrade you from X
- to Y (since its unsupported). That's not really what we ant either.
+ [Impact]
+ See the original bug description.
+ 
+ [Test Case]
+ - for ubuntu-release-upgrader -
+ 1) run 'do-release-upgrade --help' and man 'do-release-upgrade'
+ 2) observe that it says '-d' is to 'Check if upgrading to the latest devel release is possible'
+ 3) install the version of ubuntu-release-upgrader from -proposed
+ 4) repeat step 1
+ 5) Observe that '-d' is documented as 'If using the latest supported release, upgrade to the development release'
+ 
+ - for update-manager -
+ Use the same test case as for ubuntu-release-upgrader but replace do-release-upgrade with update-manager and ubuntu-release-upgrader with update-manager.
+ 
+ [Regression Potential]
+ None as these are documentation changes and any typos in them will be revealed by the test case. It is worth noting that these are translated strings but it seems better to break translations and be accurate rather than have a translation of something that is incorrect.
+ 
+ [Original Description]
+ The -d switch for update-manager is documented as 'Check if upgrading to the latest devel release is possible'.  This implies that no matter what release you are running the -d switch check if you can upgrade to the devel release (Artful right now) however, this isn't actually what the -d switch does. Right now the -d switch will take you to the next unsupported release of Ubuntu, so in a few weeks will upgrade you from X to Y (since its unsupported). That's not really what we want either.
  
  The -d switch will be changed so that it only upgrades you to the
  development release of Ubuntu if you are running the release immediately
  before the development release. So right now it would only work from
  Zesty to Artful.
  
  The help documentation for -d needs to be changed to reflect what it
  actually does.

-- 
You received this bug notification because you are a member of Ubuntu
Foundations Bugs, which is subscribed to ubuntu-release-upgrader in
Ubuntu.
https://bugs.launchpad.net/bugs/1700829

Title:
  -d switch isn't accurately described

Status in ubuntu-release-upgrader package in Ubuntu:
  Fix Released
Status in update-manager package in Ubuntu:
  Fix Released
Status in ubuntu-release-upgrader source package in Xenial:
  In Progress
Status in update-manager source package in Xenial:
  In Progress
Status in ubuntu-release-upgrader source package in Zesty:
  In Progress
Status in update-manager source package in Zesty:
  In Progress
Status in ubuntu-release-upgrader source package in Artful:
  Fix Released
Status in update-manager source package in Artful:
  Fix Released

Bug description:
  [Impact]
  See the original bug description.

  [Test Case]
  - for ubuntu-release-upgrader -
  1) run 'do-release-upgrade --help' and man 'do-release-upgrade'
  2) observe that it says '-d' is to 'Check if upgrading to the latest devel release is possible'
  3) install the version of ubuntu-release-upgrader from -proposed
  4) repeat step 1
  5) Observe that '-d' is documented as 'If using the latest supported release, upgrade to the development release'

  - for update-manager -
  Use the same test case as for ubuntu-release-upgrader but replace do-release-upgrade with update-manager and ubuntu-release-upgrader with update-manager.

  [Regression Potential]
  None as these are documentation changes and any typos in them will be revealed by the test case. It is worth noting that these are translated strings but it seems better to break translations and be accurate rather than have a translation of something that is incorrect.

  [Original Description]
  The -d switch for update-manager is documented as 'Check if upgrading to the latest devel release is possible'.  This implies that no matter what release you are running the -d switch check if you can upgrade to the devel release (Artful right now) however, this isn't actually what the -d switch does. Right now the -d switch will take you to the next unsupported release of Ubuntu, so in a few weeks will upgrade you from X to Y (since its unsupported). That's not really what we want either.

  The -d switch will be changed so that it only upgrades you to the
  development release of Ubuntu if you are running the release
  immediately before the development release. So right now it would only
  work from Zesty to Artful.

  The help documentation for -d needs to be changed to reflect what it
  actually does.

To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu/+source/ubuntu-release-upgrader/+bug/1700829/+subscriptions